Importar metadados do Oracle

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Neste documento, descrevemos como importar metadados do Oracle para o Knowledge Catalog (antigo Dataplex Universal Catalog) usando um conector do Knowledge Catalog.

Esse conector oferece suporte a instâncias do Oracle hospedadas no local, no Google Cloud, ou em outros ambientes de nuvem.

Antes de importar metadados do Oracle, conclua as seguintes tarefas:

1. Conceda os papéis e permissões necessários.
2. Ative as APIs Knowledge Catalog e serviço de transferência de dados do BigQuery.
3. Atenda aos pré-requisitos do Oracle.
4. Atenda aos pré-requisitos de rede.

Permissões e papéis do IAM

Para criar e gerenciar um job de conector do Knowledge Catalog, você precisa de papéis do Identity and Access Management (IAM) que concedam permissões para o Knowledge Catalog e o serviço de transferência de dados do BigQuery.

Para receber as permissões necessárias para configurar um conector do Oracle, peça ao administrador para conceder a você os papéis do IAM a seguir:

• Para criar e gerenciar grupos de entradas: administrador do catálogo do Dataplex (roles/dataplex.catalogAdmin), editor do catálogo do Dataplex (roles/dataplex.catalogEditor), ou proprietário do grupo de entradas do Dataplex (roles/dataplex.entryGroupOwner) no projeto.
• Para criar e gerenciar jobs de transferência do serviço de transferência de dados do BigQuery: administrador do BigQuery (roles/bigquery.admin) no projeto.
• Para visualizar registros no Cloud Logging: leitor de registros (roles/logging.viewer) no projeto.

Além disso, é necessário conceder ao agente de serviço do serviço de transferência de dados do BigQuery ([e-mail]) a permissão dataplex.entryGroups.import ou o papel de importador de grupos de entradas do Dataplex (roles/dataplex.entryGroupImporter). É possível conceder esse papel no nível do projeto ou do grupo de entradas.

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Ativar APIs

Ative as APIs Knowledge Catalog e serviço de transferência de dados do BigQuery.

Ativar as APIs

Pré-requisitos do Oracle

Verifique se você atende aos pré-requisitos para transferências do Oracle. Para mais detalhes, consulte Pré-requisitos do Oracle na documentação do serviço de transferência de dados do BigQuery.

Além dos pré-requisitos do serviço de transferência de dados do BigQuery, a instância do Oracle precisa atender aos seguintes requisitos:

• Versão mínima:a versão 12 ou mais recente do Oracle é necessária para oferecer suporte a atributos de metadados do banco de dados, como type e parentContainer.

• Privilégios mínimos:é necessário conceder os seguintes privilégios ao usuário do banco de dados:

  Permissões básicas (necessárias para todas as configurações):

  GRANT SELECT_CATALOG_ROLE TO USER_NAME;
  GRANT CREATE SESSION TO USER_NAME;
  GRANT SELECT ON SYS.COL$ TO USER_NAME;
  

  Permissões para acessar um esquema específico (Oracle versão 23 e mais recente):

  GRANT SELECT ANY TABLE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  GRANT EXECUTE ANY PROCEDURE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  GRANT EXECUTE ANY TYPE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  GRANT ALTER ANY TRIGGER ON SCHEMA TARGET_SCHEMA TO USER_NAME;
  

  Permissões para acessar todos os outros esquemas:

  GRANT SELECT ANY TABLE TO USER_NAME;
  GRANT EXECUTE ANY PROCEDURE TO USER_NAME;
  GRANT EXECUTE ANY TYPE TO USER_NAME;
  GRANT ALTER ANY TRIGGER TO USER_NAME;
  

  Substitua:

  • USER_NAME: o usuário do banco de dados que você quer configurar.
  • TARGET_SCHEMA: o nome do esquema do Oracle que você quer acessar.

Pré-requisitos de rede

Um anexo de rede para conexão via Private Service Connect é necessário ao se conectar com segurança a bancos de dados externos ou fontes de dados de nuvem de terceiros com um endereço IP particular dentro de uma rede privada, para permitir que o serviço de transferência de dados do BigQuery acesse seu banco de dados.

Se você se conectar a um ambiente local ou a uma instância hospedada na nuvem usando um endereço IP público, um anexo de rede não será necessário.

Configurar um conector do Oracle

Configure um conector do Oracle usando o Google Cloud console ou a API.

Console

1. No Google Cloud console, acesse a página Knowledge Catalog.

   Acessar o Knowledge Catalog

2. No menu de navegação, na seção Gerenciar, clique em Conectores.

3. Clique em Adicionar conexão.

4. Na lista Conectores, selecione o card Oracle.

5. Na seção Detalhes da fonte de dados, forneça detalhes de conexão para sua instância do Oracle:

   • Em Anexo de rede, selecione um anexo de rede existente, se necessário, ou crie um.
   • Insira o host, a porta, o nome do banco de dados, o tipo de conexão, o nome de usuário e a senha.
   • Se você estiver usando o TLS, selecione um modo TLS e forneça um certificado PEM confiável. Para mais informações, consulte Configuração do TLS.
   • Em Objetos de metadados do Oracle a serem importados, clique em Procurar para selecionar objetos.

6. Na seção Configurações de destino:

   • Clique em Procurar e selecione um grupo de entradas do Knowledge Catalog para armazenar os metadados importados ou clique em Criar novo grupo de entradas.
   • Escolha se quer definir permissões no grupo de entradas agora ou mais tarde. Recomendamos definir permissões para que os usuários possam visualizar os metadados importados. Se você não concedeu o papel de importador de grupos de entradas do Dataplex (roles/dataplex.entryGroupImporter) ou a dataplex.entryGroups.import permissão ao agente de serviço do serviço de transferência de dados do BigQuery ([e-mail]) no nível do projeto, conceda-o no nível do grupo de entradas.

7. No campo Nome de exibição da seção Nome de configuração do conector, insira um nome para o job de importação de metadados.

8. Na seção Opções de programação, configure a frequência do job de importação de metadados. Se você selecionar Sob demanda, o job será executado apenas quando você o acionar manualmente.

9. Opcional: na seção Opções de notificação, configure notificações por e-mail ou Pub/Sub para falhas de job.

10. Opcional: na seção Opções avançadas, configure as definições de criptografia. Se você selecionar uma chave de criptografia gerenciada pelo cliente (CMEK), observe que a chave será usada para criptografar todos os dados temporários preparados antes de iniciar os jobs de importação de metadados do Knowledge Catalog. Ela não é usada para criptografar os metadados no grupo de entradas de destino do Knowledge Catalog.

11. Clique em Salvar.

REST

Use o projects.locations.transferConfigs.create método. No TransferConfig recurso, configure os seguintes campos:

• Defina o campo dataSourceId como "oracle".
• No campo metadataDestination, preencha o objeto dataplexConfiguration com o caminho do recurso do grupo de entradas de destino do Knowledge Catalog: projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

Depois de criar o job, o Knowledge Catalog programa a primeira execução de acordo com sua configuração ou você pode iniciá-la manualmente.

A seguir

• Saiba como gerenciar jobs de conector.