10 Conecte-se à Computação

Esta seção aborda como conectar a computação no Oracle AI Data Platform a outras ferramentas de business intelligence.

Conexões

Você pode conectar seu Oracle AI Data Platform ao Oracle Analytics Cloud ou a outras ferramentas de business intelligence.

Você pode se conectar à AI Data Platform de diferentes ferramentas de business intelligence usando um JDBC ou ODBC personalizado fornecido pela AI Data Platform. A Plataforma de Dados de IA também suporta conexões de ferramentas de BI comercial de terceiros (Tableau, Power BI) ou ferramentas de BI de código aberto, como DBeaver. Para estabelecer conexão com essas ferramentas, você precisa dos detalhes da conexão do cluster de computação na sua Plataforma de Dados AI, que você pode encontrar na guia Detalhes da conexão. As informações necessárias variam de acordo com o produto do qual você está se conectando.


Guia de detalhes da conexão do cluster de computação Dev_cluster_1

Conecte o Oracle Analytics à Oracle AI Data Platform

Você pode se conectar ao catálogo ou tabelas gerenciadas pela sua instância do Oracle AI Data Platform de uma instância do Oracle Analytics Cloud.

Para criar uma conexão do Oracle Analytics com a AI Data Platform, você precisa de um arquivo de conexão da AI Data Platform e uma chave de API do Analytics Cloud.

Obter um Arquivo de Configuração de Conexão do Oracle Analytics

Você precisa fazer download de um arquivo config.json da sua instância do Oracle AI Data Platform para conectá-lo ao Oracle Analytics.

Você precisa de um cluster de computação com pelo menos 2 OCPUs, 32 GB de memória para nós de driver e de trabalho e pelo menos 2 workers.
  1. Navegue até seu espaço de trabalho e clique em Compute.

    Página de computação aberta com cluster de computação Cluster_High destacado

  2. Clique no cluster ao qual você deseja estabelecer conexão com o Oracle Analytics.
  3. Na guia Detalhes da conexão, clique no ícone Fazer Download abaixo do logotipo do Oracle Analytics Cloud. Um arquivo config.json será baixado para sua máquina.

    Página de computação do cluster Cluster_High aberta com a guia Detalhes da conexão e o download do Oracle Analytics Cloud destacado

Conectar-se ao Oracle Analytics

Você pode se conectar ao catálogo ou tabelas gerenciadas pela sua instância do Oracle AI Data Platform de uma instância do Oracle Analytics.

Certifique-se de ter um arquivo de configuração de conexão da AI Data Platform antes de criar sua conexão no Oracle Analytics. Consulte Obter um Arquivo de Configuração de Conexão do Oracle Analytics.
As conexões do Oracle Analytics com instâncias da AI Data Platform suportam apenas um catálogo por conexão. Você precisa criar conexões adicionais para usar mais de um catálogo.
  1. Na página inicial do Oracle Analytics, clique em Criar, em seguida, clique em Conexão.
  2. Clique em Oracle AI Data Platform.
  3. Informe um nome e descrição para a sua conexão.
  4. Em Local, especifique onde salvar a conexão. Para compartilhar a conexão com outros usuários, salve-a em /Shared Folders.
  5. No Oracle Analytics Cloud, para Detalhes da Conexão, clique em Selecionar, navegue até o arquivo config.json e clique em Abrir.
  6. Selecione Chave de API como o tipo de autenticação.
  7. Em Chave de API Pública, clique em Gerar e depois em Copiar.
  8. No OCI, adicione uma Chave de API.
    1. No OCI, clique no ícone do usuário e depois clique em Definições do Usuário.
    2. Em Meu perfil, clique em Tokens e chaves e, em seguida, clique em Adicionar chave de API.
    3. Selecione Colar uma chave pública e copie a chave gerada na Etapa 7. Em seguida, clique em Adicionar.
    Aguarde de dois a três minutos para que a chave da API seja sincronizada.
  9. Em Catálogo, especifique o nome do Catálogo a ser usado em seus conjuntos de dados.
    Se a lista Catálogo não for carregada e você vir a mensagem de alerta "O usuário não tem privilégios suficientes para executar a operação", aguarde um pouco mais para que a chave da API seja sincronizada.
  10. Clique em Salvar.
  11. Teste sua nova conexão criando um conjunto de dados.

Se você tiver seguido as instruções e ainda estiver tendo problemas para salvar sua conexão ou listar seus esquemas, talvez seja necessário reiniciar o cluster.

Fazer Download do Driver JDBC

Você pode fazer download do driver JDBC na guia Detalhes da conexão e configurá-lo para diferentes ferramentas de BI.

  1. Navegue até seu espaço de trabalho e clique em Compute.
  2. Clique no cluster que deseja conectar a uma ferramenta de BI compatível com JDBC e clique em Conexões.
  3. Clique em Download do Driver JDBC.

Configurar DBeaver

Você precisa instalar o DBeaver e preparar arquivos baixados do Oracle AI Data Platform para poder conectá-lo a um cluster de computação na sua AI Data Platform.

  1. Faça download e instale o cliente DBeaver. Você pode usar versões Community ou Enterprise, mas elas devem ser pelo menos 22.x.DBeaver só está disponível para Windows, Mac OS X, Eclipse Plugin e Linux.
  2. Descompacte o arquivo em Download JDBC Driver.
  3. Nos arquivos descompactados, descompacte o arquivo do driver simbaSpark.zip.

Configurar o DBeaver com o Driver JDBC Spark Simba

Você pode configurar o DBeaver para estabelecer conexão com um cluster de computação no Oracle AI Data Platform.

Você deve ter instalado o DBeaver e extraído os arquivos simbaSpark.zip baixados da Plataforma de Dados AI.
  1. Abra o DBeaver.
  2. Clique em Navegador de Banco de Dados.
  3. Clique em Gerenciador de Drivers.
  4. Clique em Novo.
  5. Digite AI Data Platform como o Nome do Driver.
  6. Clique em Bibliotecas.
  7. Clique em Adicionar Pasta.
  8. Navegue até o local da extração sparkSimba.zip.
  9. Clique em Localizar Classe.
  10. Selecione OK.
  11. Defina Classe do driver como com.simba.spark.jdbc.Driver.
  12. Clique em Definições.
  13. Defina Nome da Classe como com.simba.spark.jdbc.Driver.
  14. Clique em OK.

Criar uma Conexão de Banco de Dados no DBeaver

Para conectar o DBeaver a um cluster de computação no Oracle AI Data Platform, primeiro você precisa criar uma conexão de banco de dados no DBeaver.

Você deve ter configurado o DBeaver com o driver JDBC Spark Simba baixado da Plataforma de Dados AI. Para obter mais informações, consulte Configurar DBeaver com o Driver JDBC do Spark Simba.
  1. Abra o DBeaver.
  2. Clique em Banco de Dados.
  3. Clique em Nova Conexão de Banco de Dados.
  4. Clique em All.
  5. Selecione Plataforma de Dados de IA.
  6. Clique em Próximo.
  7. Informe o URL do driver JDBC. Você pode encontrar o URL JDBC na guia Detalhes da conexão do seu cluster de computação na Plataforma de Dados AI.
  8. Clique em Concluir.

Conecte o DBeaver ao Oracle AI Data Platform usando JDBC

Depois que o DBeaver estiver configurado e tiver uma conexão de banco de dados com o Oracle AI Data Platform, você poderá concluir a conexão entre o DBeaver e a AI Data Platform.

  1. Abra o DBeaver.
  2. Clique em Conectar.
  3. Escolha estabelecer conexão com um token de autorização ou uma chave de API.
    • Conectar usando token de autorização
      • Use um token não especificando nenhum perfil no URL se você não tiver um perfil DEFAULT. Por exemplo: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5

        O URL abre uma janela do navegador.

        Acesse a tenancy em que a instância da AI Data Platform é criada.

        Para obter mais informações, consulte Autenticação Baseada em Token para a CLI.

    • Estabeleça conexão usando uma chave de API especificando o Perfil do OCI com ociProfile=<profile_name> no URL de conexão.

      • Use a autenticação de chave de API para estabelecer conexão com uma instância da AI Data Platform.

        Use a chave de API especificando o Perfil do OCI com ociProfile=<profile_name> no URL de conexão. Por exemplo, para usar a Demonstração do nome do Perfil do OCI: jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo

        Para obter mais informações, consulte Chaves e OCIDs Necessários.

  4. O DBeaver cria uma conexão para ler metadados e uma conexão para todas as outras operações. Se você estiver limitado para conexões, poderá desativar a segunda para que o DBeaver use uma conexão para todas as operações.
    1. Clique em Preferências.
    2. Clique em Comum.
    3. Clique em Metadados.
    4. Desmarque Abrir conexão separada para leituras de metadados.

Fazer Download do Driver ODBC

Você pode fazer download do driver ODBC na guia Detalhes da conexão e configurá-lo para diferentes ferramentas de BI.

  1. Navegue até seu espaço de trabalho e clique em Compute.
  2. Clique no cluster que deseja conectar a uma ferramenta de BI compatível com ODBC e clique em Conexões.
  3. Clique em Fazer Download do Driver ODBC.
  4. Selecione o sistema operacional apropriado na lista.

    Menu suspenso do ODBC Driver OS aberto com as opções Mac, Windows e Linx exibidas