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

Observação

Recentemente, revisamos os documentos do gateway de dados local. Nós os dividimos em conteúdo específico para Power BI e conteúdo geral que se aplica a todos os serviços compatíveis com o gateway.We recently revised the on-premises data gateway docs. We split them into content that's specific to Power BI and general content that applies to all services that the gateway supports. No momento, você está no conteúdo do Power BI.You're currently in the Power BI content. Para fornecer comentários sobre este artigo ou sobre a experiência geral de documentos do gateway, role até a parte inferior do artigo.To provide feedback on this article, or the overall gateway docs experience, scroll to the bottom of the article.

Depois de instalar o gateway de dados local, será necessário adicionar fontes de dados que possam ser usadas com o gateway.After you install the on-premises data gateway, you need to add data sources that can be used with the gateway. Este artigo aborda como trabalhar com gateways e fontes de dados Oracle para a atualização agendada ou para o DirectQuery.This article looks at how to work with gateways and Oracle data sources either for scheduled refresh or for DirectQuery.

Instalar o cliente OracleInstall the Oracle client

Para conectar o gateway ao servidor Oracle, o Provedor de dados Oracle para .NET (ODP.NET) precisa ser instalado e configurado.To connect the gateway to your Oracle server, the Oracle Data Provider for .NET (ODP.NET) must be installed and configured. O ODP.NET faz parte do ODAC (Oracle Data Access Components).ODP.NET is part of the Oracle Data Access Components (ODAC).

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 o cliente ser instalado, configure o arquivo tnsnames.ora com as informações apropriadas para seu banco de dados.After the client is installed, configure your tnsnames.ora file with the proper information for your database. O Power BI Desktop e o gateway saem do net_service_name definido no arquivo tnsnames.ora.Power BI Desktop and the gateway go off of the net_service_name defined in the tnsnames.ora file. Se net_service_name não estiver configurado, você não poderá se conectar.If the net_service_name isn't configured, you can't connect. O caminho padrão de tnsnames.ora é [Oracle Home Directory]\Network\Admin\tnsnames.ora.The default path for tnsnames.ora is [Oracle Home Directory]\Network\Admin\tnsnames.ora. Para saber mais sobre como configurar arquivos tnsnames.ora, consulte Oracle: Parâmetros de nomenclatura 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

Este é o formato básico de uma entrada em tnsname.ora:Here's the basic format of an entry in tnsname.ora:

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's 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 uma fonte de dadosAdd a data source

Para obter mais informações sobre como adicionar uma fonte de dados, consulte Adicionar uma fonte de dados.For more information about how to add a data source, see Add a data source. Em Tipo de Fonte de Dados, selecione Oracle.Under Data Source Type, select Oracle.

Adicionar a fonte de dados Oracle

Depois de selecionar o tipo de fonte de dados Oracle, preencha as informações da fonte de dados, que incluem o Servidor e o Banco de dados.After you select the Oracle data source type, fill in the information for the data source, which includes Server and Database.

Em Método de Autenticação, você pode escolher Windows ou Básico.Under Authentication Method, you can choose either Windows or Basic. Escolha Básico se você planeja usar uma conta criada com a autenticação do Oracle em vez da autenticação do Windows.Choose Basic if you plan to use an account that's 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 to 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 saber mais sobre como as credenciais são armazenadas, confira Armazenar credenciais criptografadas na nuvem.To learn more about how credentials are stored, see Store encrypted credentials in the cloud.

Preencher as configurações de fonte de dados

Depois de preencher tudo, selecione Adicionar.After you fill in everything, select Add. 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's on-premises. Você verá Conexão Bem-sucedida se tiver êxito.You see Connection Successful if it succeeded.

Exibindo o status da conexão

Configurações avançadasAdvanced settings

Opcionalmente, você pode configurar o nível de privacidade para sua fonte de dados.Optionally, you can configure the privacy level for your data source. Essa configuração controla como os dados podem ser combinados.This setting controls how data can be combined. Ela é usada somente para a atualização agendada.It's only used for scheduled refresh. A configuração de nível de privacidade não se aplica ao DirectQuery.The privacy-level setting doesn't apply to DirectQuery. Para saber mais sobre os níveis de privacidade para sua fonte de dados, confira Níveis de privacidade (Power Query).To learn more about privacy levels for your data source, see Privacy levels (Power Query).

Definir o nível de privacidade

Usar a fonte de dadosUse the data source

Depois de criar a fonte de dados, ela está disponível para uso com as conexões do DirectQuery ou por meio da atualização agendada.After you create the data source, it's 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.The server and database names must 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. Esses nomes devem corresponder.These names must match. Por exemplo, se você fornecer um endereço IP como nome do servidor no Power BI Desktop, precisará usar o endereço IP como 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 must 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 Instalar o cliente Oracle.For more information about the tnsnames.ora file, see Install the Oracle client.

Esse requisito existe para o DirectQuery e para a atualização agendada.This requirement is the case for both DirectQuery and scheduled refresh.

Usar a fonte de dados com conexões do DirectQueryUse the data source with DirectQuery connections

Verifique 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.Make sure that the server and database names match between Power BI Desktop and the configured data source for the gateway. Para que seja possível publicar os conjuntos de dados do DirectQuery, você também precisa verificar se o usuário está listado na guia Usuários da fonte de dados.You also need to make sure your user is listed in the Users tab of the data source 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. Para obter mais informações sobre como usar o DirectQuery, consulte Usar o DirectQuery no Power BI Desktop.For more information about how to use DirectQuery, see Use DirectQuery in Power BI Desktop.

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 to work. 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 might take several minutes after you create the data source within the gateway for the connection to be usable.

Usar a fonte de dados com a atualização agendadaUse the data source with scheduled refresh

Se 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're listed in the Users tab of the data source configured within the gateway and the server name and database name match, you see the gateway as an option to use with scheduled refresh.

Exibir os usuários

Solução de problemasTroubleshooting

Você poderá encontrar vários erros do Oracle quando a sintaxe de nomenclatura estiver incorreta ou não estiver configurada corretamente:You might encounter several 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 especificado.ORA-12154: TNS:could not resolve the connect identifier specified.
  • ORA-12514: o ouvinte TNS no momento não sabe sobre o serviço solicitado no descritor de conexão.ORA-12514: TNS:listener does not currently know of service requested in connect descriptor.
  • ORA-12541: TNS: nenhum ouvinte.ORA-12541: TNS:no listener.
  • ORA-12170: TNS: ocorrência de tempo limite de conexão.ORA-12170: TNS:connect timeout occurred.
  • ORA-12504: O ouvinte TNS não recebeu SERVICE_NAME em CONNECT_DATA.ORA-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 might occur if the Oracle client either isn't installed or isn't 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's installed, verify that the tnsnames.ora file is properly configured and you're 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 also need to make sure that the net_service_name is the same between the machine that uses Power BI Desktop and the machine that runs the gateway. Para obter mais informações, consulte Instalando o cliente Oracle.For more information, see Install the Oracle client.

Observação

Você também poderá enfrentar um problema de compatibilidade entre a versão do servidor Oracle e a versão do cliente Oracle.You might also encounter a compatibility issue between the Oracle server version and the Oracle client version. Normalmente, é recomendável que essas versões sejam correspondentes.Typically, you want these versions 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 that relates to the gateway, see Troubleshooting the on-premises data gateway.

Próximas etapasNext steps

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