Snowflake

Resumo

Capacidades suportadas

• Importar
• DirectQuery (modelos semânticos do Power BI)
• Opções avançadas
  • Especificar um valor de texto a ser usado como Nome da função
  • Colunas de Relacionamento
  • Tempo limite de ligação em segundos
  • Tempo limite do comando em segundos
  • Base de Dados
  • Instrução SQL nativa

Ligar ao armazém de dados Snowflake a partir do Power Query Desktop

Para fazer a conexão com um armazém de dados Snowflake, execute as seguintes etapas:

1. Selecione Obter Dados da faixa de opções Página Inicial no Power BI Desktop, selecione Banco de Dados nas categorias à esquerda, selecione Floco de Neve e selecione Conectar.

   

2. Na janela Snowflake que aparece, digite o nome do seu servidor Snowflake em Servidor e o nome do seu armazém de computação Snowflake em Warehouse.

   

3. Opcionalmente, insira valores em quaisquer opções avançadas que você deseja usar para modificar a consulta de conexão, como um valor de texto a ser usado como um nome de função ou um tempo limite de comando. Para obter mais informações, vá para Conectar usando opções avançadas.

4. Selecione OK.

5. Para iniciar sessão no seu armazém de computação Snowflake, introduza o seu nome de utilizador e palavra-passe e, em seguida, selecione Ligar.

   

   Nota

   Depois de inserir seu nome de usuário e senha para um servidor Snowflake específico, o Power BI Desktop usa essas mesmas credenciais em tentativas de conexão subsequentes. Você pode modificar essas credenciais indo para Opções de arquivo > e configurações > Configurações da fonte de dados. Para mais informações, consulte Alterar o método de autenticação.

   Se você quiser usar a opção de conta da Microsoft, a integração do Snowflake Microsoft Entra ID deve ser configurada no lado do Snowflake. Para obter mais informações, aceda a Power BI SSO para Snowflake - Primeiros Passos.

6. No Navegador, selecione um ou vários elementos para importar e usar no Power BI Desktop. Em seguida, selecione Carregar para carregar a tabela no Power BI Desktop ou Transformar Dados para abrir o editor do Power Query, onde pode filtrar e refinar o conjunto de dados que pretende utilizar e, em seguida, carregar esse conjunto de dados refinado no Power BI Desktop.

   

7. Selecione Importar para importar dados diretamente para o Power BI ou selecione DirectQuery e, em seguida, selecione OK. Para obter mais informações, vá para Usar DirectQuery no Power BI Desktop.

   Nota

   O logon único (SSO) do Microsoft Entra ID suporta apenas DirectQuery.

   

Ligar a uma base de dados Snowflake a partir do Power Query Online

Para estabelecer a ligação, siga os seguintes passos:

1. Selecione a opção Floco de neve na seleção do conector.

2. Na caixa de diálogo Floco de neve exibida, digite o nome do servidor e do depósito.

   

3. Introduza quaisquer valores nas opções avançadas que pretende utilizar. Se existirem opções avançadas não representadas na IU, pode editá-las posteriormente no Editor Avançado no Power Query.

4. Insira suas credenciais de conexão, incluindo selecionar ou criar uma nova conexão, qual gateway você gostaria de usar e um nome de usuário e senha.

5. Selecione Avançar para conectar-se ao banco de dados.

6. No Navegador, selecione os dados de que necessita e, em seguida, selecione Transformar dados para transformar os dados no Power Query Editor.

   

Conecte-se usando opções avançadas

O Power Query fornece um conjunto de opções avançadas que pode adicionar à sua consulta, se necessário.

A tabela seguinte lista todas as opções avançadas que pode definir no Power Query.

Depois de selecionar as opções avançadas necessárias, selecione OK no Power Query Desktop ou Next no Power Query Online para se conectar ao seu banco de dados do Snowflake.

Implementação do conector Snowflake 2.0

Em janeiro de 2025, introduzimos uma nova implementação para o conector Snowflake para melhorar a integração com o Snowflake. Este conector está geralmente disponível desde julho de 2025. Recomendamos que atualize o Power BI Desktop e o gateway de dados local para a versão mais recente, para beneficiar das capacidades mais recentes. Fornecer-nos feedback para nos ajudar a continuar a melhorar o conector.

A implementação do conector Snowflake 2.0 é construída usando o driver ADBC (Arrow Database Connectivity ) de código aberto. ADBC fornece um conjunto de interfaces padrão para interagir com dados Arrow, sendo especialmente eficiente na obtenção de grandes conjuntos de dados com sobrecarga mínima, sem serialização ou cópia. O driver ADBC também incorpora melhorias de segurança, como a segurança da memória e a recolha de lixo. Além disso, a colaboração com a comunidade de código aberto permite atualizações mais rápidas, utilizando ferramentas modernas e processos seguros de ciclo de vida de desenvolvimento (SDL).

Para permitir que você aproveite esses aprimoramentos de desempenho e segurança, a partir de julho de 2025, todas as conexões recém-criadas no Desktop usam automaticamente a implementação 2.0. Você também pode testar a implementação 2.0 atualizando suas consultas existentes e adicionando o Implementation="2.0" sinalizador da seguinte maneira no Snowflake.Databases.

Source = Snowflake.Databases("contoso.snowflakecomputing.com", "CONTOSO_WH", [Implementation="2.0"])

Para ajudar no diagnóstico de qualquer problema potencial, você pode encontrar os Implementation e DriverType detalhes em seus logs do Mashup, como o exemplo a seguir. Se você encontrar algum problema durante a transição, entre em contato com o suporte. Enquanto isso, para mitigar automaticamente, você pode remover Implementation="2.0" para continuar usando o conector ODBC para evitar a interrupção dos negócios antes que o problema seja resolvido.

{
   "Start":"2024-11-02T00:14:02.7968686Z",
   "Action":"Engine/Module/Snowflake/IO/Snowflake/Implementation",
   "ResourceKind":"Snowflake",
   "ResourcePath":"powerbi.snowflakecomputing.com ;DEMO_WH",
   "HostProcessId":"29200",
   "Implementation":"2.0",
   "DriverType":"ADBC",
   "ProductVersion":"2.139.0.0 (Main)+eda56ecd858054173a4d11db9c63a6da5cf92a99",
   "ActivityId":"106f16b6-cfbb-4853-9f20-ed45486486d2",
   "Process":"Microsoft.Mashup.Container.NetFX45",
   "Pid":38560,
   "Tid":1,
   "Duration":"00:00:00.0000291"
}

As seguintes opções estão disponíveis desde o lançamento de julho de 2025:

• UseHighPrecision: Controla a precisão de como os campos Snowflake NÚMERO(38,0) devem ser manipulados. Se nenhum valor for especificado, o conector consultará Snowflake usando a SHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT' consulta. Se o valor no for definido, o conector usará a escala especificada pela coluna. Um true valor trata NUMBER(38,0) como um tipo decimal. O valor false trata NUMBER(38,0) como um tipo Int64. Se a escala for superior a 0, a coluna é considerada como um tipo Duplo.
• DateTimePrecision: Controla a precisão de como os valores de carimbo de data/hora do Snowflake são tratados. A Snowflake normalmente armazena valores de timestamp com precisão de nanossegundos. No ADBC, esta precisão pode causar uma exceção de overflow para datas anteriores a 1677 ou após 2262, segundo Snowflake. Valores válidos para esta opção são nulos, nanoseconds, ou microseconds. Um valor nulo usa nanoseconds por padrão. Recomendamos que os utilizadores que necessitem de datas anteriores a 1677 ou depois de 2262 utilizem esta microseconds definição. Se os utilizadores precisarem de manter a precisão até à décima milionésima posição antes de 1677 ou depois de 2262, recomendamos manter o driver ODBC.

Se você precisar usar proxy para se conectar ao Snowflake, consulte a instrução de configuração de proxy. O driver usa variáveis de ambiente para as configurações de proxy.

A tabela seguinte contém um resumo das melhorias de conectores lançadas em versões anteriores:

Resolução de Problemas

Erro: Erro de compilação SQL: O objeto não existe ou a operação não pode ser executada

O erro ocorre quando o sistema não consegue encontrar o objeto especificado. Muitas vezes, esse erro é devido ao usuário ter um nome de banco de dados inválido definido como seu banco de dados padrão.

Verifique se um nome de banco de dados padrão válido é usado para a propriedade DEFAULT_NAMESPACE: DESC USERusername

Para atualizar o nome do banco de dados padrão: alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>. Para mais informações, consulte a documentação do Snowflake.

Limitações e problemas conhecidos

Problemas conhecidos na implementação do conector Snowflake 2.0

Atualmente, a implementação do conector Snowflake 2.0 tem os seguintes problemas conhecidos. Há um trabalho contínuo para uma correção e a documentação será atualizada quando uma correção for lançada.

• A consulta Snowflake com count distinct lógica retorna resultado incorreto.
• Ao criar relações, encontre o erro Object reference not set to an instance of an object. A relação ainda pode ser definida após cancelar a janela pop-up.
• Aumento do uso de memória. O tempo de carregamento geral é normalmente mais rápido usando Implementation="2.0", mas o consumo de memória também pode ser maior, podendo causar problemas como Resource Governing: This operation was canceled because there wasn't enough memory to finish running it. Either reduce the memory footprint of your dataset by doing things such as limiting the amount of imported data, or if using Power BI Premium, increase the memory of the Premium capacity where this dataset is hosted. em alguns casos.

Problemas resolvidos

Hífens em nomes de bancos de dados

Se um nome de banco de dados contiver um hífen, poderá encontrar um ODBC: ERROR[42000] SQL compilation error. Esse problema foi resolvido na versão de setembro de 2024.

Visual de filtro para tipo de dados booleano

O visual do slicer para o tipo de dados Boolean não está a funcionar como esperado na versão de junho de 2024. Essa não funcionalidade é um problema conhecido. Como uma solução temporária, os usuários podem converter o tipo de dados booleano em seus relatórios em texto navegando para: Transferência -> Tipo de Dados -> Texto. Uma correção é fornecida na versão de outubro de 2024.

Vistas não visíveis com Implementation="2.0"

Em algumas versões da versão de março de 2025 do Power BI Desktop, pode encontrar um problema em que as visões não ficam visíveis quando se utiliza o conector Snowflake 2.0 (Implementation="2.0"). Este problema foi resolvido desde o último lançamento do Power BI Desktop, em março de 2025. Para tentar novamente, atualize a sua instalação.

Os valores TIMESTAMP_NTZ são UTC com Implementation="2.0"

tipos TIMESTAMP_LTZ não estão a ser convertidos para o fuso horário local, mas estão a devolver o valor UTC quando se utiliza a implementação do conector Snowflake 2.0 (Implementation="2.0"). Por exemplo, fazer SELECT CURRENT_TIMESTAMP a partir do Snowflake é retornar a hora UTC, não o fuso horário local do usuário. Esse problema foi resolvido na versão de julho de 2025.

O índice estava fora dos limites da matriz ao usar Implementation="2.0"

Em alguns cenários, um erro é gerado indicando o Index was outside the bounds of the array ao usar a implementação do conector Snowflake 2.0 (Implementation="2.0"). Esse problema foi resolvido na versão de junho de 2025.

Conteúdo relacionado

• Conectar-se ao Snowflake no Serviço do Power BI