Amazon Redshift

Resumo

Property Value
Conector Ícone do Amazon Redshift Amazon Redshift
Produtos Power BI (modelos semânticos)
Power Query Online
Estado de liberação Disponibilidade geral
Category Database
Tipos de autenticação Amazon Redshift
Conta da Microsoft
Variante de fonte de dados AmazonRedshift
Documentação de referência da função AmazonRedshift.Database

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Observação

A implementação 2.0 do conector do Redshift agora está disponível para todos. Saiba mais sobre esse recurso.

Pré-requisitos

  • Amazon Web Services (AWS)

Capacidades suportadas

  • Importação
  • DirectQuery (modelos semânticos Power BI)
  • Opções avançadas
    • Nome do provedor
    • Tamanho do lote
    • Instrução SQL

Parameters

Ponto de entrada:AmazonRedshift.Database

Número obrigatório de parâmetros: 2

Importar dados de um banco de dados do Amazon Redshift.

Retorna uma tabela listando as tabelas no cluster server do Amazon Redshift no banco de dados database. Um parâmetro de registro opcional, optionspode ser especificado para controlar as seguintes opções:

  • Provider Name: um valor de texto a ser usado como o Nome do Provedor para a conexão. Isso é usado ao usar Microsoft Authentication.
  • Batch Size: o número de linhas buscadas em uma única chamada para o servidor.
Parameter Nome de exibição Required Tipo Group Valores de exemplo Anulável
servidor Server Yes enviar SMS "contoso.redshift.amazonaws.com:5439" falso
banco de dados Database Yes enviar SMS desenvolvedor falso
Opções Opções Avançadas Não Registro anulável Opções Avançadas true

Campos em options

Campo Nome de exibição Required Tipo Group Valores de exemplo Anulável Optional
options.ProviderName Nome do Provedor Não enviar SMS Opções Avançadas "Insira um valor de nome de provedor" falso true
options.BatchSize Tamanho do Lote Não número Opções Avançadas 100 falso true

Conectar-se do Power Query Desktop

Para se conectar a dados do Amazon Redshift:

  1. Selecione a opção Amazon Redshift na seleção Obter Dados.

  2. No Servidor, insira o nome do servidor onde seus dados estão localizados. Como parte do campo Servidor, você também pode especificar uma porta no seguinte formato: URLdoServidor:Porta. No Banco de Dados, insira o nome do banco de dados do Amazon Redshift que você deseja acessar. Neste exemplo, contoso.redshift.amazonaws.com:5439 é o nome do servidor e o número da porta, dev é o nome do banco de dados e o modo de conectividade de dados está configurado como Importar.

    Captura de tela da caixa de diálogo de conexão do Amazon Redshift, com o nome do servidor de exemplo, a porta e o nome do banco de dados inseridos.

    Você também pode escolher algumas opções avançadas opcionais para sua conexão. Para obter mais informações, acesse Connect usando opções avançadas.

    Depois de concluir o preenchimento e selecionar todas as opções necessárias, selecione OK.

  3. Se você estiver se conectando a esse banco de dados pela primeira vez, insira suas credenciais nas caixas Nome de usuário e senha do tipo de autenticação do Amazon Redshift. Depois, selecione Conectar.

    Captura de tela da caixa de diálogo de autenticação, com o Amazon Redshift selecionado como o tipo de autenticação.

    Para obter mais informações, acesse Autenticação com uma fonte de dados.

  4. Depois de você se conectar com sucesso, aparece uma janela Navegador com os dados disponíveis no servidor. Escolha um ou mais dos elementos que você deseja importar.

    Captura de tela do Navegador com o elemento customers selecionado e os dados desse elemento exibidos no lado direito.

    Observação

    O Navegador exibe os seguintes tipos de objeto do Amazon Redshift: Tabela, Exibição, Tabela Externa, Exibição Externa, Tabela do Sistema e Modo de Exibição do Sistema. Outros tipos de objeto, como objetos de banco de dados do consumidor, não são mostrados no Navegador, mas ainda podem ser consultáveis diretamente referenciando-os pelo nome em sua consulta, dependendo de suas permissões.

  5. Depois de selecionar os elementos desejados, selecione Load para carregar os dados ou Transform Data para continuar transformando os dados no editor de Power Query.

  6. Selecione o modo de conectividade de dados Importar ou DirectQuery e selecione OK.

    Captura de tela das configurações de conexão, com Importar e DirectQuery como as configurações que você pode selecionar.

Conectar-se do Power Query Online

Para se conectar a dados do Amazon Redshift:

  1. Selecione a opção Amazon Redshift na página Power Query - Escolha a fonte de dados.

  2. No Servidor, insira o nome do servidor onde seus dados estão localizados. Como parte do campo Servidor, você também pode especificar uma porta no seguinte formato: URLdoServidor:Porta. No Banco de Dados, insira o nome do banco de dados do Amazon Redshift que você deseja acessar. Neste exemplo, contoso.redshift.amazonaws.com:5439 é o nome do servidor e o número da porta, e dev é o nome do banco de dados.

    Captura de tela da página de conexão, com o nome do servidor de exemplo, a porta e o nome do banco de dados inseridos.

    Você também pode escolher algumas opções avançadas opcionais para sua conexão. Para obter mais informações, acesse Connect usando opções avançadas.

  3. Se necessário, selecione o gateway de dados no local em Gateway de dados.

  4. Selecione o tipo de autenticação que você deseja usar no Tipo de autenticação e insira suas credenciais.

  5. Marque ou desmarque Usar Conexão Criptografada, dependendo se você deseja usar uma conexão criptografada ou não.

  6. Selecione Avançar para continuar.

  7. No Navegador, selecione os dados que você precisa e então selecione Transforme os dados. Essa seleção abre o editor de Power Query para que você possa filtrar e refinar o conjunto de dados que deseja usar.

    Captura de tela do Navegador online com o elemento customers selecionado e os dados desse elemento exibidos no lado direito.

Informações adicionais

Opções avançadas

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

A tabela a seguir descreve todas as opções avançadas que você pode definir em Power Query.

Opção avançada Descrição
Nome do Provedor Fornece um ARN (Nome do Recurso da Amazon), que identifica exclusivamente os recursos do AWS.
Tamanho do lote Especifica o número máximo de linhas a serem recuperadas por vez do servidor ao buscar dados. Um número pequeno causará mais chamadas para o servidor ao recuperar um conjunto de dados grande. Um grande número de linhas pode melhorar o desempenho, mas pode causar alto uso de memória. O padrão é consulta de uma única linha.
Instrução SQL Para obter informações, consulte Importar dados de um banco de dados usando a consulta de banco de dados nativo.

Habilitar Microsoft Entra ID SSO (logon único) para o Amazon Redshift

Damos suporte ao Microsoft Entra ID SSO por meio do serviço Power BI na nuvem e também por meio do gateway de dados local. Para obter mais informações sobre como habilitar o SSO (logon único) do Microsoft Entra ID para todos os conectores, acesse a Visão geral do SSO (logon único) para gateways de dados locais no Power BI.

Microsoft Entra ID logon único (SSO) por meio do serviço Power BI

Para configurar uma nova conexão no serviço do Power BI:

  1. Em serviço do Power BI, selecione Admin portal na lista de configurações.

    Captura de tela do menu de configurações abertas, com o portal de administração enfatizado.

  2. Habilite a opção SSO do Redshift.

    Captura de tela da opção de SSO do Redshift com o botão Habilitado habilitado.

Logon único do Microsoft Entra ID para Amazon Redshift com um gateway de dados local

Antes de habilitar Microsoft Entra ID SSO para o Amazon Redshift, primeiro você deve habilitar Microsoft Entra ID SSO para todas as fontes de dados que dão suporte a Microsoft Entra ID SSO com um gateway de dados local:

  1. Em serviço do Power BI, selecione Admin portal na lista de configurações.

    Captura de tela do menu Configurações com o portal de administração enfatizado.

  2. Em configurações Tenant, habilite Azure SSO (AD Single-Sign On) para Gateway.

    Screenshot da caixa de diálogo Microsoft Entra ID SSO para gateway, com a opção Habilitada ativada.

Depois de habilitar Microsoft Entra ID SSO para todas as fontes de dados, habilite Microsoft Entra ID SSO para o Amazon Redshift:

  1. Habilite a opção SSO do Redshift.

    Captura de tela da caixa de diálogo SSO do Redshift com a opção Habilitada habilitada.

  2. Selecione Gerenciar gateways na lista de configurações.

    Captura de tela do menu Configurações com Gerenciar gateways enfatizado.

  3. Selecione um gateway e, em seguida, selecione Escolher Fonte de Dados.

  4. Na guia Configurações da Fonte de Dados, insira um valor no Nome do Provedor. O parâmetro Provider Name é necessário ao usar Microsoft Entra ID e precisa ser especificado nas configurações Advanced.

    Selecione também Usar SSO via Azure AD para consultas DirectQuery.

    Screenshot da guia Configurações da Fonte de Dados com o Nome do Provedor e Uso de SSO via Azure AD para consultas DirectQuery com as configurações avançadas enfatizadas.

Implementação do conector 2.0

O conector do Amazon Redshift tem uma nova implementação criada no driver Amazon Redshift 2.x de software livre. Para habilitar isso na área de trabalho, acesse Arquivo>Opções e configurações>Opções>Recursos de visualização.

Habilite o novo recurso de implementação do conector do Amazon Redshift:

Captura de tela da caixa de diálogo de opção de visualização com a opção Usar novo conector do Amazon Redshift selecionada.

Isso adicionará a opção [Implementation="2.0"] à sua conexão, que informa Power BI usar o novo driver.

let
    Source = AmazonRedshift.Database("my.redshift.amazonaws.com","dev",[Implementation="2.0"]),
    northwind = Source{[Name="northwind"]}[Data],
    orders1 = northwind{[Name="orders"]}[Data]
in
    orders1

Isso só será adicionado para novas conexões do Redshift depois que a opção for habilitada no Power Query desktop. Você também pode adicionar essa opção a qualquer conexão existente adicionando a opção [Implementation="2.0"].

Todas as conexões serão migradas automaticamente para o driver V2 em uma iteração futura. Você também pode ver qual versão do driver do Redshift você está usando em seus logs do Mashup:

{
   "Start":"2026-02-16T23:20:18.7947784Z",
   "Action":"Engine/Module/AmazonRedshift/IO/AmazonRedshift/Version",
   "ResourceKind":"AmazonRedshift",
   "ResourcePath":"my.redshift.amazonaws.com;dev",
   "HostProcessId":"36784",
   "PartitionKey":"Section1/orders/orders1",
   "Implementation":"2.0",
   "DriverName":"Amazon Redshift ODBC Driver",
   "UseV2Features":"True",
   "ProductVersion":"2.153.0.0 (Main)+fdaf4307c2163bd9933182691631ca4d966ba1ac",
   "ActivityId":"dddd3333-ee44-5555-66ff-777777aaaaaa",
   "Process":"Microsoft.Mashup.Container.NetFX45",
   "Pid":37024,
   "Tid":1,
   "Duration":"00:00:00.0000192"
}