Gerenciar sua fonte de dados – OracleManage your data source - Oracle

Depois de instalar o gateway de dados local, será necessário adicionar fontes de dados que podem ser usadas com o gateway.Once you have installed the on-premises data gateway, you will need to add data sources that can be used with the gateway. Este artigo abordará como trabalhar com gateways e fontes de dados.This article will look at how to work with gateways and data sources. Você pode usar a fonte de dados do Oracle para uma atualização agendada ou para o DirectQuery.You can use the Oracle data source either for scheduled refresh or for DirectQuery.

Baixar e instalar o gatewayDownload and install the gateway

É possível baixar o gateway no serviço do Power BI.You can download the gateway from the Power BI service. Selecione Downloads > Gateway de Dados ou vá para a página de download do gateway.Select Downloads > Data Gateway, or by going to the gateway download page.

Aviso

Para que o gateway possa se conectar ao servidor Oracle, o Provedor de dados Oracle para .NET (ODP.NET) precisa ser instalado e configurado.In order for the gateway to be able to connect to your Oracle server, the Oracle Data Provider for .NET (ODP.NET) needs to be installed and configured. Isso faz parte do ODAC (Oracle Data Access Components).This is part of the Oracle Data Access Components (ODAC). Para obter mais informações sobre como baixar o provedor Oracle, veja Instalando o cliente Oracle abaixo.For more information on how to download the Oracle provider, see Installing the Oracle Client below.

Instalando o cliente OracleInstalling the Oracle client

Para versões de 32 bits do Power BI Desktop, use o seguinte link para baixar e instalar o cliente Oracle de 32 bits:For 32-bit versions of Power BI Desktop, use the following link to download and install the 32-bit Oracle client:

Para versões de 64 bits do Power BI Desktop ou para o gateway de dados local, use o seguinte link para baixar e instalar o cliente Oracle de 64 bits:For 64-bit versions of Power BI Desktop, or for the on-premises data gateway, use the following link to download and install the 64-bit Oracle client:

Após a instalação, você precisará configurar o arquivo tnsnames.ora com as informações apropriadas para seu banco de dados.Once that is installed, you will need to configure your tnsnames.ora file with the proper information for your database. O Power BI Desktop e o gateway sairão do net_service_name definido no arquivo tnsnames.ora.Power BI Desktop and the gateway will go off of the net_service_name defined in the tnsnames.ora file. Se não estiver configurado, você não poderá se conectar.If it isn't configured, you will not be able to connect. O caminho padrão de tnsnames.ora é o seguinte: [Oracle Home Directory]\Network\Admin\tnsnames.ora.The default path for tnsnames.ora is the following: [Oracle Home Directory]\Network\Admin\tnsnames.ora. Para obter mais informações sobre como configurar arquivos tnsnames.ora, consulte Oracle: parâmetros de nomeação Local (tnsnames.ora).For more information about how to configure tnsnames.ora files, see Oracle: Local Naming Parameters (tnsnames.ora).

Exemplo de entrada de arquivo tnsnames.oraExample tnsnames.ora file entry

O formato básico de uma entrada em tnsname.ora é o seguinte.The basic format of an entry in tnsname.ora is the following.

net_service_name=
 (DESCRIPTION=
   (ADDRESS=(protocol_address_information))
   (CONNECT_DATA=
     (SERVICE_NAME=service_name)))

Aqui está um exemplo de informações de servidor e porta preenchidas.Here is an example of the server and port information filled in.

CONTOSO =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = oracleserver.contoso.com)(PORT = 1521))
    (CONNECT_DATA =
      (SERVER = DEDICATED)
      (SERVICE_NAME = CONTOSO)
    )
  )

Adicionar um gatewayAdd a gateway

Para adicionar um gateway, basta baixar e instalar o gateway em um servidor de seu ambiente.To add a gateway, simply download and install the gateway on a server in your environment. Depois de instalar o gateway, ele será mostrado na lista de gateways em Gerenciar gateways.After you have installed the gateway, it will show in the lists of gateways under Manage gateways.

Observação

Gerenciar gateways não será mostrado até que você seja o administrador de, pelo menos, um gateway.Manage gateways will not show up until you are the admin of at least one gateway. Isso pode acontecer ao ser adicionado como um administrador ou ao instalar e configurar um gateway.This can happen either by being added as an admin or you installing and configuring a gateway.

Excluir um gatewayRemove a gateway

A exclusão de um gateway também excluirá as fontes de dados contidas nele.Removing a gateway will also delete any data sources under that gateway. Isso também interromperá todos os painéis e relatórios que dependem dessas fontes de dados.This will also break any dashboards and reports that rely on those data sources.

  1. Selecione o ícone de engrenagem no canto superior direito > Gerenciar gateways.Select the gear icon in the upper-right corner > Manage gateways.
  2. Gateway > RemoverGateway > Remove

Adicionar uma fonte de dadosAdd a data source

É possível adicionar uma fonte de dados selecionando um gateway e clicando em Adicionar fonte de dados ou acessando Gateway > Adicionar fonte de dados.You can add a data source by either selecting a gateway and click Add data source, or go to Gateway > Add data source.

Você pode selecionar o Tipo de Fonte de Dados na lista.You can then select the Data Source Type from the list.

Em seguida, é necessário preencher as informações sobre a fonte de dados, que incluem o Servidor e o Banco de Dados.You will then want to fill in the information for the data source which includes the Server and the Database.

Também é necessário escolher um Método de Autenticação.You will also need to choose an Authentication Method. Ele pode ser Windows ou Básico.This can either be Windows or Basic. Use Básico se for usar uma conta criada com a autenticação do Oracle em vez da autenticação do Windows.You would want to choose Basic if you are going to use an account that is created within Oracle instead of Windows Authentication. Em seguida, insira as credenciais que serão usadas para esta fonte de dados.Then enter the credentials that will be used for this data source.

Observação

Todas as consultas à fonte de dados serão executadas com essas credenciais.All queries to the data source will run using these credentials. Para obter mais informações, veja o artigo principal sobre o gateway de dados local para saber mais sobre como as credenciais são armazenadas.For more information, see the main on-premises data gateway article to learn more about how credentials are stored.

Você pode clicar em Adicionar depois preencher tudo.You can click Add after you have everything filled in. Agora você pode usar esta fonte de dados para a atualização agendada ou para o DirectQuery, em relação a um servidor Oracle local.You can now use this data source for scheduled refresh, or DirectQuery, against an Oracle server that is on-premises. Você verá Conexão Bem-sucedida se tiver êxito.You will see Connection Successful if it succeeded.

Configurações avançadasAdvanced settings

Você pode configurar o nível de privacidade para sua fonte de dados.You can configure the privacy level for your data source. Ele controla como os dados podem ser combinados.This controls how data can be mashed up. É usado somente para a atualização agendada.This is only used for scheduled refresh. Não se aplica ao DirectQuery.It does not apply to DirectQuery. Saiba maisLearn more

Remover uma fonte de dadosRemove a data source

A remoção de uma fonte de dados interromperá todos os painéis ou relatórios que dependem da fonte de dados em questão.Removing a data source will break any dashboards or reports that rely on the given data source.

Para remover uma Fonte de Dados, vá para a Fonte de Dados > Remover.To remove a Data Source, go to the Data Source > Remove.

Gerenciar administradoresManage administrators

Na guia Administradores, para o gateway, você pode adicionar e remover os usuários (ou grupos de segurança) que podem administrar o gateway.On the Administrators tab for the gateway, you can add and remove users (or security groups) that can administer the gateway.

Gerenciar usuáriosManage users

Na guia Usuários, da fonte de dados, você pode adicionar e remover os usuários ou grupos de segurança que podem usar essa fonte de dados.On the Users tab, for the data source, you can add, and remove, users, or security groups, that can use this data source.

Observação

A lista de usuários só controla quem tem permissão de publicar relatórios.The users list only controls who are allowed to publish reports. Os proprietários de relatório podem criar painéis ou pacotes de conteúdo e compartilhá-los com outros usuários.The report owners can create dashboards, or content packs, and share those with other users. Usuários que consomem relatório ou dashboard não precisam estar na lista de usuários.Users that are consuming the report or dashboard do not need to be in the users list.

Usando a fonte de dadosUsing the data source

Depois de criar a fonte de dados, ela estará disponível para uso com as conexões do DirectQuery ou por meio da atualização agendada.After you have created the data source, it will be available to use with either DirectQuery connections, or through scheduled refresh.

Aviso

Os nomes do servidor e do banco de dados devem corresponder entre o Power BI Desktop e a fonte de dados no gateway de dados local!Server and database name have to match between Power BI Desktop and the data source within the on-premises data gateway!

O vínculo entre o conjunto de dados e a fonte de dados no gateway baseia-se nos nomes do servidor e do banco de dados.The link between your dataset and the data source within the gateway is based on your server name and database name. Eles devem corresponder!These have to match! Por exemplo, se você fornecer um Endereço IP para o nome do servidor, no Power BI Desktop, será necessário usar o Endereço IP para a fonte de dados na configuração do gateway.For example, if you supply an IP Address for the server name, within Power BI Desktop, you will need to use the IP Address for the data source within the gateway configuration. Esse nome também deve corresponder a um alias definido no arquivo tnsnames.ora.This name also has to match an alias defined within the tnsnames.ora file. Para obter mais informações sobre o arquivo tnsnames.ora, consulte Instalando o cliente Oracle.For more information about the tnsnames.ora file, see Installing the Oracle Client.

Isso acontece para o DirectQuery e a atualização agendada.This is the case for both DirectQuery and scheduled refresh.

Usando a fonte de dados com conexões do DirectQueryUsing the data source with DirectQuery connections

Você precisará verificar se os nomes do servidor e do banco de dados correspondem entre o Power BI Desktop e a fonte de dados configurada para o gateway.You will need to make sure the server and database name matches between Power BI Desktop and the configured data source for the gateway. Você também precisará certificar-se de que o usuário está listado na guia Usuários da fonte de dados para publicar os conjuntos de dados do DirectQuery.You will also need to make sure your user is listed in the Users tab of the data source in order to publish DirectQuery datasets. A seleção, para o DirectQuery, ocorre no Power BI Desktop quando você importa dados pela primeira vez.The selection, for DirectQuery, occurs within Power BI Desktop when you first import data. Saiba maisLearn more

Após a publicação, por meio do Power BI Desktop ou do recurso Obter Dados, seus relatórios deverão começar a funcionar.After you publish, either from Power BI Desktop or Get Data, your reports should start working. Pode levar vários minutos, após a criação da fonte de dados no gateway, para que a conexão seja utilizável.It may take several minutes, after creating the data source within the gateway, for the connection to be usable.

Usando a fonte de dados com a atualização agendadaUsing the data source with scheduled refresh

Se você estiver listado na guia Usuários da fonte de dados configurada no gateway e houver a correspondência entre os nomes do servidor e do banco de dados, você verá o gateway como uma opção a ser usada com a atualização agendada.If you are listed in the Users tab of the data source configured within the gateway, and the server and database name match, you will see the gateway as an option to use with scheduled refresh.

Solução de problemasTroubleshooting

Você pode encontrar vários erros do Oracle quando a sintaxe de nomenclatura estiver incorreta ou não configurada corretamente.You may encounter serveral errors from Oracle when the naming syntax is either incorrect or not configured properly.

  • ORA-12154: TNS: não foi possível resolver o identificador de conexão especificadoORA-12154: TNS: could not resolve the connect identifier specified
  • ORA-12514: ouvinte TNS não sabe, no momento, de serviço solicitado no descritor de conexãoORA-12514: TNS listener does not currently know of service requested in connect descriptor
  • ORA-12541: TNS: nenhum ouvinteORA-12541: TNS: no listener
  • ORA-12170: TNS: ocorrência de tempo limite de conexãoORA-12170: TNS:Connect timeout occurred
  • ORA-12504: SERVICE_NAME em CONNECT_DATA não foi atribuído ao ouvinte TNSORA-12504: TNS listener was not given the SERVICE_NAME in CONNECT_DATA

Esses erros poderão ocorrer se o cliente Oracle não estiver instalado ou não estiver configurado corretamente.These errors could occur if either the Oracle client is not installed, or if it is not configured properly. Se ele estiver instalado, verifique se o arquivo tnsnames.ora está configurado corretamente e se você está usando o net_service_name adequado.If it is installed, you will want to verify the tnsnames.ora file is properly configured and you are using the proper net_service_name. Você também precisará garantir que o net_service_name seja o mesmo entre o computador que está usando o Power BI Desktop e o computador que está executando o gateway.You will also need to make sure that the net_service_name is the same between the machine using Power BI Desktop and the machine that is running the gateway. Para obter mais informações, consulte Instalando o cliente Oracle.For more information, see Installing the Oracle Client.

Observação

Você também poderá enfrentar um problema devido à compatibilidade entre a versão do servidor Oracle e a versão do cliente Oracle.You may also be hitting an issue due to compatability between the Oracle server version and the Oracle client version. Normalmente, eles deverão corresponder.Typically you want these to match.

Para obter informações adicionais de solução de problemas relativas ao gateway, veja Solução de problemas do gateway de dados local.For additional troubleshooting information relating to the gateway, see Troubleshooting the on-premises data gateway.

Próximas etapasNext steps

Gateway de dados localOn-premises data gateway
Detalhes sobre o gateway de dados localOn-premises data gateway - in-depth
Solução de problemas do gateway de dados localTroubleshooting the on-premises data gateway
Power BI PremiumPower BI Premium

Mais perguntas?More questions? Experimente perguntar à Comunidade do Power BITry asking the Power BI Community