Configurar a conexão do banco de dados Snowflake

Este artigo descreve as etapas para criar uma conexão de banco de dados Snowflake.

Tipos de autenticação suportados

O conector de banco de dados Snowflake suporta os seguintes tipos de autenticação para cópia e Dataflow Gen2, respectivamente.

O conector Snowflake suporta os seguintes métodos de autenticação:

• Microsoft Entra ID (recomendado): Permite autenticação forte baseada em identidade sem armazenar nomes de utilizador ou palavras-passe.

  • No Microsoft Fabric, este método de autenticação pode ser suportado pela identidade do espaço de trabalho em experiências suportadas (como Conjuntos de Dados e Dataflows Gen2), permitindo que o Fabric autentique no Snowflake usando a identidade gerida do espaço de trabalho.

• Identidade de Espaço de Trabalho: Uma identidade gerida associada a um espaço de trabalho Microsoft Fabric. Quando se autentica com o Microsoft Entra ID, as experiências Fabric suportadas (como Datasets e Dataflows Gen2) podem usar a identidade do espaço de trabalho para se autenticar no Snowflake. Este método permite que o Fabric aceda ao Snowflake usando uma identidade associada ao espaço de trabalho, em vez de credenciais individuais do utilizador.

• Autenticação por pares de chaves (ADBC): Autenticação baseada em certificados para cenários suportados.

• Principal de Serviço (SPN): Os princípios de serviço são suportados com o Snowflake para cenários em que é necessária uma identidade ao nível da aplicação e não de utilizador. O suporte depende da configuração do Snowflake e do método de autenticação utilizado.

Configurar sua conexão para Dataflow Gen2

Pode ligar o Dataflow Gen2 no Microsoft Fabric ao Snowflake usando conectores Power Query. Siga estes passos para criar a sua ligação:

1. Verifique capacidades, limitações e considerações para garantir que o seu cenário é suportado.
2. Obtenha dados em Fabric.
3. Ligue-se a uma base de dados Snowflake.

Capabilities

• Import
• 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

Obter dados

Para obter dados no Data Factory:

1. No lado esquerdo do Data Factory, selecione Workspaces.

2. No espaço de trabalho do Data Factory, selecione Novo>Dataflow Gen2 para criar um novo fluxo de dados.

   

3. No Power Query, selecione Obter dados na barra de ferramentas ou selecione Obter dados de outra fonte na visualização atual.

   

4. Na página Escolher a fonte dos dados , use Pesquisar para procurar o nome do conector, ou selecione Ver mais à direita da lista de conectores para ver todos os conectores disponíveis na Data Factory.

   

5. Se optares por visualizar mais conectores, podes ainda usar a Pesquisa para encontrar o nome do conector ou escolher uma categoria para ver uma lista de conectores associados a essa categoria.

   

Liga-te a uma base de dados Snowflake

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 houver opções avançadas que não estejam representadas na interface, podes editá-las no Editor Avançado no Power Query mais tarde.

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. Em Navigator, selecione os dados que necessita e depois selecione Transform data para transformar os dados em Editor do Power Query.

   

Limitações e considerações

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.
• Aumento do uso de memória. O tempo total de carregamento é tipicamente mais rápido usando Implementation="2.0", mas o consumo de memória também pode ser maior, causando em alguns casos 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.

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 alguma versão da atualização de março de 2025 do Power BI Desktop, pode encontrar um problema em que as visualizações não são visíveis ao utilizar a implementação do conector Snowflake 2.0 (Implementation="2.0"). Este problema foi resolvido desde o lançamento mais recente do Power BI Desktop em março de 2025. Para tentar novamente, atualize a sua instalação.

Configure a sua ligação em Gerir ligações e gateways

A tabela seguinte contém um resumo das propriedades necessárias para a ligação Snowflake:

Para instruções específicas para configurar a sua ligação em Gerir ligações e gateways, siga estes passos:

1. No cabeçalho da página no serviço de Integração de Dados, selecione Configurações>Gerenciar conexões e gateways

   

2. Selecione Novo na parte superior da faixa de opções para adicionar uma nova fonte de dados.

   

   O painel Nova conexão aparece no lado esquerdo da página.

   

3. No painel Nova conexão, escolha Nuvem e especifique os seguintes campos:

   

   • Nome da conexão: especifique um nome para sua conexão.
   • Tipo de ligação: Selecione um tipo para a sua ligação.
   • Servidor: Especifique o nome do host da conta Snowflake. Por exemplo, contoso.snowflakecomputing.com.
   • Armazém: Especifique o armazém virtual predefinido usado para a sessão após a ligação. Por exemplo, CONTOSO_WH.

4. Em Método de autenticação, selecione a sua autenticação no menu suspenso e complete a configuração correspondente. O conector Snowflake suporta os seguintes tipos de autenticação:

   • Snowflake
   • Conta Microsoft
   • Par de chaves

   

5. Opcionalmente, defina o nível de privacidade que deseja aplicar. Os valores permitidos são Nenhum, Organizacional, Privacidade e Público. Para mais informações, consulte níveis de privacidade na documentação do Power Query.

6. As Opções Avançadas são usadas apenas para ligação de teste. Os itens que utilizam esta ligação devem especificar estas opções nas consultas.

   

   • Especifique um valor de texto para usar como nome da Função: Especifique um valor de texto para usar como nome da Função.
   • Tempo limite da ligação em segundos: Especifique o tempo de espera (em segundos) ao tentar estabelecer uma ligação antes de terminar a tentativa e gerar um erro.
   • Tempo de espera em segundos: Especifique o tempo de espera (em segundos) ao tentar executar um comando antes de terminar a tentativa e gerar um erro.
   • Implementação: Especifique os seus modos de implementação para a ligação de teste.

7. Selecione Criar para criar sua conexão. Se todas as credenciais estiverem corretas, a sua criação é testada e salva com sucesso. Se não estiver correta, a criação falha com erros.

Authentication

Esta secção lista as instruções para cada tipo de autenticação suportado pelo conector Snowflake:

• Snowflake
• Conta Microsoft
• Par de chaves

Autenticação por floco de neve

• Nome de usuário: especifique o nome de login para o usuário do Snowflake.
• Palavra-passe: Especifique a palavra-passe do utilizador do Snowflake.

Autenticação da Conta Microsoft

Selecione Editar credenciais, que mostra a interface de iniciação de sessão. Introduza a sua conta e palavra-passe para iniciar sessão na sua conta organizacional. Depois de iniciar sessão, volte à página de Nova ligação.

Autenticação de par de chaves

Para usar a autenticação de par de chaves, você precisa configurar e criar um usuário de autenticação de par de chaves no Snowflake consultando Autenticação de par de chaves & Rotação de par de chaves.

• Nome de usuário: especifique o nome de login para o usuário do Snowflake.

• Chave privada: carregue o arquivo de chave privada usado para autenticação de par de chaves. Depois de carregar o ficheiro de chave privada, o serviço deteta automaticamente se está encriptado ou não e apresenta ou oculta a frase secreta em conformidade.

• Senha: especifique a senha usada para descriptografar a chave privada. Isto é necessário apenas se o ficheiro de chave privada estiver encriptado.

  

Conteúdo relacionado

• Para mais informações sobre este conector, consulte a documentação do conector da base de dados Snowflake.
• Configurar o Snowflake em uma atividade de cópia