Adicionar ou remover uma fonte de dados de gateway
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. Este artigo também informa como remover uma fonte de dados, usá-la com atualização agendada ou DirectQuery e gerenciar o acesso do usuário.
Você também pode fazer a maioria das operações de gerenciamento de fonte 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
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.
Selecione Novo na parte superior da tela para adicionar uma nova fonte de dados.
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.
Insira informações sobre a fonte de dados. Para o SQL Server, forneça o Servidor e o Banco de Dados.
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.
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.
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, adicione NT-AUTHORITY\Usuários autenticados (S-1-5-11) ao grupo Usuários da máquina local.
Opcionalmente, em Logon único, você pode configurar o logon único (SSO) para sua fonte de dados. 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 de dados locais 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 data 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.
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.
Selecione Criar. Em Configurações, você verá Nova conexão criada se o processo for bem-sucedido.
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 deixarão de funcionar.
Para remover uma fonte de dados, selecione-a na tela Conexões em Gerenciar Conexões e Gateways e selecione Remover.
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 SERVER\INSTANCE no Power BI Desktop, deverá usar o mesmo formato na fonte de dados configurada para o gateway.
Se sua conta estiver listada 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.
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
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.
Selecione a fonte de dados onde você deseja adicionar usuários.
Selecione Gerenciar usuários na faixa de opções superior
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.
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.
Selecione Compartilhar e o nome do membro adicionado será adicionado à lista de pessoas que podem publicar relatórios que usam essa fonte de dados.
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. Esta máquina descriptografa as credenciais 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.
Nota
O MySQL não é suportado no gateway de dados pessoal local.
Conteúdos relacionados
- Gerenciar sua fonte de dados - Analysis Services
- Gerencie sua fonte de dados - SAP HANA
- Gerenciar sua fonte de dados - SQL Server
- Gerencie sua fonte de dados - Oracle
- Gerenciar sua fonte de dados - importação e atualização agendada
- Orientação para implantar um gateway de dados
Tem dúvidas? Experimente a Comunidade do Power BI.