Adicionar ou remover uma fonte de dados de gateway

  • Artigo

Nota

Dividimos os documentos do gateway de dados local em conteúdo específico do Power BI e conteúdo geral que se aplica a todos os serviços suportados pelo gateway. Você está atualmente no conteúdo do Power BI. Para fornecer comentários sobre este artigo ou sobre a experiência geral de documentos do gateway, role até a parte inferior do artigo.

O Power BI dá suporte a muitas fontes de dados locais e cada fonte tem seus próprios requisitos. Você pode usar um gateway para uma única fonte de dados ou várias fontes de dados. Neste exemplo, você aprenderá a adicionar o SQL Server como uma fonte de dados. As etapas são semelhantes para outras fontes de dados.

Você também pode fazer a maioria das operações de gerenciamento de fontes de dados usando APIs. Para obter mais informações, consulte APIs REST (gateways).

Se você não tiver um gateway instalado, instale um gateway de dados local para começar.

Adicionar uma origem de dados

  1. No cabeçalho da página no serviço Power BI, selecione o ícone ConfiguraçõesSettings gear icon e, em seguida, selecione Gerenciar conexões e gateways.

    Screenshot that shows selecting Manage connections and gateways.

  2. Selecione Novo na parte superior da tela para adicionar uma nova fonte de dados.

  3. Na tela Nova conexão, selecione Local, forneça o nome do cluster de gateway no qual você deseja criar a conexão, forneça um Nome de conexão e selecione o Tipo de fonte de dados. Para este exemplo, escolha SQL Server.

  4. Insira informações sobre a fonte de dados. Para o SQL Server, forneça o Servidor e o Banco de Dados.

    Screenshot of how to fill in data source settings.

    Nota

    Para usar a fonte de dados para relatórios e painéis do Power BI, os nomes do servidor e do banco de dados devem corresponder entre o Power BI Desktop e a fonte de dados adicionada ao gateway.

  5. Selecione um Método de Autenticação para usar ao se conectar à fonte de dados, Basic, Windows ou OAuth2. Para SQL Server, escolha Windows ou Basic (Autenticação SQL). Insira as credenciais da sua fonte de dados.

    Screenshot of how to fill out authentication settings.

    Se você selecionou o método de autenticação OAuth2 :

    • Qualquer consulta que seja executada por mais tempo do que a política de expiração do token OAuth pode falhar.
    • Não há suporte para contas Microsoft Entra entre locatários.

    Se você selecionou o método de autenticação do Windows , verifique se a conta tem acesso no computador. Se não tiver certeza, certifique-se de adicionar NT-AUTHORITY\Usuários autenticados (S-1-5-11) ao grupo Usuários da máquina local.

  6. Opcionalmente, em Logon único, você pode configurar o logon único (SSO) para sua fonte de dados.

    Screenshot of Single sign-on settings for data sources.

    Dependendo das configurações da sua organização, para relatórios baseados em DirectQuery, você pode configurar Usar SSO via Kerberos para consultas DirectQuery, Usar SSO via Kerberos para consultas DirectQuery e Importar ou Usar SSO via ID do Microsoft Entra para consultas DirectQuery. Você pode configurar Usar SSO via Kerberos para consultas DirectQuery e Importar para relatórios baseados em atualização.

    Se você usar Usar SSO via Kerberos para consultas DirectQuery e usar essa fonte de dados para um relatório baseado em DirectQuery, o relatório usará as credenciais do usuário que entra no serviço do Power BI. Um relatório baseado em atualização usa as credenciais inseridas nos campos Nome de usuário e Senha e o método de autenticação escolhido.

    Ao usar Usar SSO via Kerberos para consultas DirectQuery e Importar, você não precisa fornecer nenhuma credencial. Se essa fonte de dados for usada para relatórios baseados em DirectQuery, o relatório usará o usuário mapeado para o usuário do Microsoft Entra que entra no serviço do Power BI. Um relatório baseado em atualização usa o contexto de segurança do proprietário do conjunto de dados.

    Para obter mais informações sobre Usar SSO via Kerberos para consultas DirectQuery e Usar SSO via Kerberos para consultas DirectQuery e Importar, consulte Visão geral do logon único (SSO) para gateways no Power BI.

    Se você usar Usar SSO por meio da ID do Microsoft Entra para consultas DirectQuery e usar essa fonte de dados para um relatório baseado em DirectQuery, o relatório usará o token Microsoft Entra do usuário que entra no serviço do Power BI. Um relatório baseado em atualização usa as credenciais inseridas nos campos Nome de usuário e Senha e o método de autenticação escolhido. A opção Usar SSO via ID do Microsoft Entra para consultas DirectQuery estará disponível somente se o administrador do locatário permitir o Microsoft Entra SSO por meio do gateway de dados local e para as seguintes fontes de dados:

    • SQL Server
    • Azure Data Explorer
    • Snowflake

    Para obter mais informações sobre Usar SSO via ID do Microsoft Entra para consultas DirectQuery, consulte Microsoft Entra single sign-on (SSO) for Gateway.

    Nota

    O SSO para consultas de importação está disponível apenas para as fontes de dados SSO que usam a delegação restrita de Kerberos.

  7. Em Nível de privacidade geral>, opcionalmente, configure um nível de privacidade para sua fonte de dados. Essa configuração não se aplica ao DirectQuery.

    Screenshot of the Privacy level selections for data sources.

  8. Selecione Criar. Em Configurações, você verá Nova conexão criada se o processo for bem-sucedido.

    Screenshot of when the creation on connection is successful.

Agora você pode usar essa fonte de dados para incluir dados do SQL Server em seus painéis e relatórios do Power BI.

Remover uma origem de dados

Você pode remover uma fonte de dados se não usá-la mais. Se você remover uma fonte de dados, todos os painéis e relatórios que dependem dessa fonte de dados não funcionarão mais.

Para remover uma fonte de dados, selecione-a na tela Dados (visualização) em Gerenciar conexões e gateways e selecione Remover na faixa de opções superior.

Screenshot of how to remove a data source.

Usar a fonte de dados para atualização agendada ou DirectQuery

Depois de criar a fonte de dados, ela fica disponível para uso com conexões DirectQuery ou por meio de atualização agendada. Você pode saber mais sobre como configurar a atualização agendada em Configurar atualização agendada.

O link entre o conjunto de dados e a fonte de dados no gateway é baseado no nome do servidor e no nome do banco de dados. Esses nomes devem corresponder. Por exemplo, se você fornecer um endereço IP para o nome do servidor no Power BI Desktop, deverá usar o endereço IP da fonte de dados na configuração do gateway. Se você usar no Power BI Desktop, deverá usar SERVER\INSTANCE o mesmo formato na fonte de dados configurada para o gateway.

Se você estiver listado na guia Usuários da fonte de dados configurada no gateway e o nome do servidor e do banco de dados coincidirem, você verá o gateway listado como Em execução em Conexões de gateway nas Configurações da fonte de dados. Você pode selecionar Atualização agendada para configurar a atualização agendada para a fonte de dados.

Screenshot of how to create gateway connection.

Importante

Se o conjunto de dados contiver várias fontes de dados, cada fonte de dados deverá ser adicionada ao gateway. Se uma ou mais fontes de dados não forem adicionadas ao gateway, você não verá o gateway como disponível para atualização agendada.

Gerir utilizadores

Depois de adicionar uma fonte de dados a um gateway, você concede aos usuários e grupos de segurança acesso à fonte de dados específica, não ao gateway inteiro. A lista de acesso para a fonte de dados controla apenas quem tem permissão para publicar relatórios que incluem dados da fonte de dados. Os proprietários de relatórios podem criar painéis e aplicativos e, em seguida, compartilhar esses itens com outros usuários.

Você também pode conceder aos usuários e grupos de segurança acesso administrativo ao gateway.

Nota

Os usuários com acesso à fonte de dados podem associar conjuntos de dados à fonte de dados e se conectar, com base nas credenciais armazenadas ou no SSO selecionado durante a criação de uma fonte de dados.

Adicionar usuários a uma fonte de dados

  1. No cabeçalho da página no serviço Power BI, selecione o ícone Configurações e, em seguida, selecione Gerenciar conexões e gateways.

  2. Selecione a fonte de dados onde você deseja adicionar usuários.

  3. Selecione Gerenciar usuários na faixa de opções superior

  4. Na tela Gerenciar usuários, insira os usuários e/ou grupos de segurança da sua organização que podem acessar a fonte de dados selecionada.

  5. Selecione o novo nome de usuário e selecione a função a ser atribuída: Usuário, Usuário com recompartilhamento ou Proprietário.

  6. Selecione Compartilhar e o nome do membro adicionado será adicionado à lista de pessoas que podem publicar relatórios que usam essa fonte de dados.

    Screenshot of Add user.

Lembre-se de que você precisa adicionar usuários a cada fonte de dados à qual deseja conceder acesso. Cada fonte de dados tem uma lista separada de usuários. Adicione usuários a cada fonte de dados separadamente.

Remover usuários de uma fonte de dados

Na guia Gerenciar usuários da fonte de dados, você pode remover usuários e grupos de segurança que usam essa fonte de dados.

Armazene credenciais criptografadas na nuvem

Ao adicionar uma fonte de dados ao gateway, você deve fornecer credenciais para essa fonte de dados. Todas as consultas à fonte de dados são executadas usando essas credenciais. As credenciais são criptografadas com segurança com criptografia simétrica, para que não possam ser descriptografadas na nuvem. As credenciais são enviadas para a máquina que executa o gateway local, onde são descriptografadas quando as fontes de dados são acessadas.

Lista de tipos de fontes de dados disponíveis

Para obter informações sobre quais fontes de dados o gateway de dados local suporta, consulte Fontes de dados do Power BI.

Conteúdos relacionados

Tem dúvidas? Experimente a Comunidade do Power BI.