Usar ODBC para Conectar o Tableau a um Ponto Final SQL do Serviço Data Flow
Faça download, instale e configure o ODBC no SO MAC ou no Windows para conectar o Tableau a um Ponto Final SQL do serviço Data Flow.
Download e instalação do driver ODBC no Mac OS
Siga estas etapas para baixar e instalar um driver ODBC para usar com o Tableau no Mac OS.
-
Faça download do driver ODBC.
- Na barra de pesquisa global, procure
Data Flowe selecione Serviço Data Flow. - Selecione Pontos Finais SQL na navegação do lado esquerdo.
- Selecione qualquer Ponto Final SQL na lista. A página de detalhes desse Ponto Final SQL é exibida.
- Em Conectar, selecione Drivers.
- Em ODBC, selecione Fazer download do driver ODBC.
- Selecione Mac. O download começa.
- Quando o download for concluído, extraia o arquivo zip baixado.
- Na barra de pesquisa global, procure
-
Clique duas vezes para instalar o driver.
A janela de instalação é aberta.
-
Selecione Continuar.
Leia o contrato de licença exibido.
- Selecione Concordar.
- (Opcional) Para alterar o diretório de instalação a partir do padrão, selecione Alterar local de instalação, navegue até onde deseja instalar e selecione OK.
- Selecione Próximo para confirmar o diretório de instalação.
- Selecione Instalar.
-
Quando a instalação for concluída, selecione Concluir.
O diretório de instalação do driver é:
/Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib - (Opcional) Instale o ODBC Manager.
O ODBC Manager é uma ferramenta para configurar drivers e criar e gerenciar DSNs. A ferramenta é opcional porque você também pode criar DSNs manualmente editando o arquivo
odbc.iniapropriado.- Faça download do ODBC Manager no site de download.
- Clique duas vezes no arquivo
.dmgbaixado. - Clique duas vezes no arquivo
ODBC Manager.pkg. - Siga os prompts para instalá-lo.
Configuração do driver ODBC no Mac OS
Siga estas etapas para configurar o driver ODBC no Mac OS.
É possível criar DSNs do usuário (acessíveis apenas pelo usuário que o criou na estação de trabalho) ou DSNs do sistema (acessíveis por qualquer usuário conectado à estação de trabalho).
-
Obtenha o nome do host do Ponto Final SQL ao qual estabelecer conexão.
- Abra a Página Detalhes do Ponto Final SQL quando ele estiver ativo.
- Selecionar Drivers.
- Em Driver ODBC, selecione Mostrar Detalhes. Será exibido um pop-up.
- Selecione Mostrar na string Nome do host. O Nome do host completo é exibido.
- Selecione Copiar na string Nome do host. O Nome do host completo é copiado para a área de transferência.
- Salve o Nome do host para uso posterior.
- (Opcional) Crie um DSN usando o Gerenciador ODBC.
-
Inicie o Gerenciador ODBC.
-
Selecione DSN do Usuário ou DSN do Sistema conforme apropriado.
-
Selecione Adicionar.
-
Selecione
Simba OCI Spark ODBC Driver. -
Selecione OK.
-
Informe o nome do DSN, por exemplo,
Data Flow SQL Endpointe, opcionalmente, adicione uma descrição. -
Crie um par de Valores de Palavra-chave para cada parâmetro DSN.
-
Selecione Adicionar para criar um par de Valores de Palavra-chave.
-
Selecione Palavra-chave e substitua-a pelo nome do parâmetro.
-
Selecione Valor e substitua-o pelo valor do parâmetro.
- Repita as etapas g a j para cada parâmetro.
- Adicione os detalhes da autenticação da conexão:
- Para estabelecer conexão com um Ponto Final SQL usando uma chave de assinatura de API que não esteja no local padrão
~/.oci/config, adicione o parâmetro:
em queOCIConfigFile=ConfigFileLocationConfigFileLocationé o caminho absoluto para o arquivo de configuração do OCI a ser usado com a conexão.Opcionalmente, defina o campo OCIProfile com o nome do perfil do OCI no arquivo de configuração a ser usado com a conexão:
Se nenhum perfil for especificado, o conector tentará usar o perfil chamado DEFAULT:OCIProfile=<profile_to_use>OCIProfile=<profile_to_use> - Para estabelecer conexão com um Ponto Final SQL usando um token (por meio do browser), omita o parâmetro
OCIConfigFilena configuração do DSN.
- Para estabelecer conexão com um Ponto Final SQL usando uma chave de assinatura de API que não esteja no local padrão
-
Selecione OK para criar o DSN.
Observação
Se você criar o primeiro DSN de usuário ou sistema para o driver ODBC, o Gerenciador ODBC criará o arquivoodbc.inino diretório correspondente para o tipo de DSN criado. Se você criar mais DSNs, o Gerenciador ODBC adicionará entradas para cada DSN ao arquivoodbc.iniexistente. O arquivoodbc.iniestá no diretório~/Library/ODBCpara DSNs do Usuário e/Library/ODBCpara DSNs do Sistema. -
- (Opcional) Crie um DSN adicionando uma entrada a
odbc.ini.Se um DSN do Usuário ou um DSN do sistema já tiver sido criado para o driver, adicione a nova entrada ao arquivoodbc.iniexistente. Se estiver criando o primeiro DSN para o driver, crie manualmente o arquivoodbc.inie adicione a entrada ao arquivo.- Se estiver criando o primeiro DSN no arquivo
odbc.inivazio, crie uma seção para Origens de Dados ODBC (somente pela primeira vez), adicionando a seguinte linha ao arquivoodbc.ini:[ODBC Data Sources] -
Para cada DSN, especifique o seguinte:
- Em
[ODBC Data Sources], especifique o nome do DSN e o nome do driver ODBC (que é o Driver ODBC Simba OCI Spark), no formato<dsn_name> = <driver_name>. Por exemplo:[ODBC Data Sources]dsn_name = Simba OCI Spark ODBC Driver - Crie uma seção para configuração DSN, adicionando
[dsn_name]em uma nova linha no final do arquivo.[dsn_name] - Na Seção DSN criada, especifique o caminho do diretório do arquivo do driver, no formato:
Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib -
Forneça os parâmetros de conexão, como host e arquivo de configuração. Os parâmetros de conexão adicionados ao DSN não precisam ser especificados na string de conexão ODBC.
- Para estabelecer conexão com o Ponto Final SQL usando uma chave de assinatura de API (não no local padrão de
~/.oci/config), adicione o parâmetro:
em queOCIConfigFile=ConfigFileLocationConfigFileLocationé o caminho absoluto para o arquivo de configuração do OCI a ser usado para a conexão.Opcionalmente, defina o campo
OCIProfilecom o nome do perfil do OCI no arquivo de configuração a ser usado para a conexão. Se nenhum perfil for especificado, o conector tentará usar o perfil chamadoDEFAULT:OCIProfile=PROFILE_TO_USE - Para estabelecer conexão com um Ponto Final SQL usando um token (baseado em browser), você pode omitir o parâmetro
OCIConfigFilena configuração do DSN.
- Para estabelecer conexão com o Ponto Final SQL usando uma chave de assinatura de API (não no local padrão de
- Quaisquer outros parâmetros são especificados no formato
<parameter_name> = <value>.O exemplo a seguir mostra um arquivoodbc.inique configura as origens de dados usando a chave de API:[ODBC Data Sources] Data Flow SQL Endpoint = Simba OCI Spark ODBC Driver [Data Flow SQL Endpoint] Driver = /Library/simba/ocispark/lib/universal/libsparkodbc_sbu.dylib Description = Description of the connection Host = amaaaaaaezym32iajmhpmxybehc7plnvpxsmjhleiav37x5rm7pjx476ewqa.interactive.dataflowclusters.us-ashburn-1.oci.oc-test.com OCIConfigFile = /Users/username/.oci/config OCIProfile = OCIProfileToUse OCIIgnoreDriverNoPrompt = 1
- Em
- Confirme se o caminho do arquivo de configuração do OCI para usar a chave de assinatura de API para autenticação está correto.
- Valide o caminho do arquivo de chave privada na configuração.
- Se estiver criando o primeiro DSN no arquivo
Download e instalação do driver ODBC no Windows
Siga estas etapas para baixar e instalar um driver ODBC para usar com o Tableau no Windows/
-
Faça download do driver ODBC do Windows em .
- Na barra de pesquisa global, procure
Data Flowe selecione Serviço Data Flow. - Selecione Pontos Finais SQL na navegação do lado esquerdo.
- Selecione qualquer Ponto Final SQL na lista. A página de detalhes desse Ponto Final SQL é exibida.
- Em Conectar, selecione Drivers.
- Em ODBC, selecione Fazer download do driver ODBC.
- Selecione Windows. O download começa.
- Quando o download for concluído, extraia o arquivo zip baixado.
- Na barra de pesquisa global, procure
-
Extraia o arquivo
.zip. -
Clique duas vezes no instalador de 32 bits,
Simba OCI Spark 2.6 32-bit.msi, se o sistema for de 32 bits, ou clique duas vezes no instalador de 64 bits,Simba OCI Spark 2.6 64-bit.msi, se o sistema for de 64 bits. - Selecione Próximo.
- Aceite os termos do Acordo de Licença.
- Selecione Próximo.
- (Opcional) Para alterar o diretório de instalação a partir do padrão:
- Selecione Alterar....
- Navegue até o diretório necessário.
- Selecione OK.
- Para aceitar o diretório de instalação, selecione Próximo.
- Selecione Instalar.
- Quando a instalação for concluída, selecione Concluir.
Configurando o driver ODBC no Windows
Siga estas etapas para configurar o driver ODBC no Windows.
É possível criar DSNs do usuário (acessíveis apenas pelo usuário que o criou na estação de trabalho) ou DSNs do sistema (acessíveis por qualquer usuário conectado à estação de trabalho).
-
Obtenha o nome do host do Ponto Final SQL ao qual estabelecer conexão.
- Abra a Página Detalhes do Ponto Final SQL quando ele estiver ativo.
- Selecionar Drivers.
- Em Driver ODBC, selecione Mostrar Detalhes. Será exibido um pop-up.
- Selecione Mostrar na string Nome do host. O Nome do host completo é exibido.
- Selecione Copiar na string Nome do host. O Nome do host completo é copiado para a área de transferência.
- Salve o Nome do host para uso posterior.
-
Criar um DSN.
-
Abra o aplicativo de fontes de dados ODBC.
-
Selecione DSN do Usuário ou DSN do Sistema conforme apropriado.
-
Selecione Adicionar.
-
Selecione
Simba OCI Spark ODBC Driver. -
Selecione Concluir.
-
Informe o nome do DSN, por exemplo,
Data Flow SQL Endpointe, opcionalmente, adicione uma descrição. -
Para autenticação, você pode usar uma chave de assinatura de API para estabelecer conexão com um Ponto Final SQL ou pode usar um token (baseado em navegador) para estabelecer conexão com um Ponto Final SQL.
- Para usar uma chave de assinatura de API
-
- Defina Arquivo de Configuração do OCI como o caminho absoluto para o arquivo de configuração do OCI a ser usado para a conexão.
- Opcionalmente, defina o campo Perfil do OCI como o nome do perfil do OCI a ser usado para a conexão. Se nenhum perfil for especificado, o conector tentará usar o perfil chamado
DEFAULT. - Marque Ignorar SQL_DRIVER_NOPROMPT.
- Selecione OK para salvar as configurações.
- Para usar um token (baseado em navegador)
- Você pode optar por não configurar totalmente as Opções de DFI e testar apenas o DSN (etapa iv) ou selecionar Opções de DFI e continuar com as seguintes etapas:
- Defina o campo Arquivo de Configuração do OCI como um caminho que não contenha um arquivo de configuração do OCI para usar a autenticação baseada em token.
- Para exibir um Web browser usado para concluir o fluxo de autenticação baseado em token mesmo quando
SQL_DRIVER_NOPROMPTestiver ativado, marque Ignorar SQL_ DRIVER_NOPROMPT. - Selecione OK para salvar as configurações.
- Para testar o DSN, selecione Testar.
-
Selecione OK para criar o DSN.
-
Conectando o Tableau a um Ponto Final SQL do Serviço Data Flow Usando ODBC
Siga estas etapas para conectar o Tableau a um Ponto Final SQL de Fluxo de Dados Usando ODBC.
- Abra o Tableau.
-
Selecione Outros Bancos de Dados (ODBC).
Uma nova janela é aberta.
- Verifique o DSN.
-
Selecione o DSN,
Data Flow SQL Endpoint, na lista.Todos os parâmetros de conexão necessários são preenchidos automaticamente. - Selecione Entrar.