Documentação do Oracle Cloud Infrastructure

Pacote DBMS_CLOUD_IMPORT

O DBMS_CLOUD_IMPORT facilita a importação de dados de bancos de dados Oracle, bem como de bancos de dados não Oracle, usando o Oracle Heterogeneous Gateway para o Autonomous AI Database. Durante o processo de importação, os tipos de dados de origem são convertidos em tipos de dados compatíveis com a Oracle. Como resultado, quaisquer limitações e restrições do Oracle Heterogeneous Gateway também se aplicam às operações executadas por meio deste pacote.

Tópico principal: Referência de Pacote Fornecida pelo Autonomous AI Database

Resumo dos Subprogramas DBMS_CLOUD_IMPORT

Esta tabela resume os subprogramas incluídos no pacote DBMS_CLOUD_IMPORT.

Subprograma Descrição

Procedimento ADD_BY_LIKE

Cria uma tarefa de importação para importar dados de uma origem especificada para o sistema Oracle, com filtragem opcional por esquema ou tabela e opções de programação configuráveis.

Procedimento ADD_FILE

Pausa temporariamente uma tarefa de importação em execução para que ela possa ser retomada posteriormente.

Procedimento ADD_LATEST_FILES

Reinicia uma tarefa de importação suspensa anteriormente e continua o processamento a partir do ponto em que foi pausada.

Procedimento ADD_TABLE

Exclui uma tarefa de importação e remove sua definição e metadados de tarefa associados.
  • Procedimento CREATE_IMPORT_TASK
    O procedimento DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK cria e configura um job de importação para importar dados de um sistema de origem especificado para um Autonomous AI Database.
  • Procedimento SUSPEND_IMPORT_TASK
    O procedimento DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK pausa temporariamente uma tarefa de importação em execução, permitindo que ela seja retomada posteriormente.
  • Procedimento RESUME_IMPORT_TASK
    O procedimento DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK retoma uma tarefa de importação que foi suspensa anteriormente. Ele reinicia a execução da tarefa para o task_name especificado e continua a operação de importação do ponto em que foi pausada.
  • Procedimento DROP_IMPORT_TASK
    O procedimento DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK exclui uma tarefa de importação e remove sua definição e metadados de tarefa associados.

Tópico principal: Pacote DBMS_CLOUD_IMPORT

Procedimento CREATE_IMPORT_TASK

O procedimento DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK cria e configura um job de importação para importar dados de um sistema de origem especificado para um Autonomous AI Database.

Você deve estar conectado como o usuário ADMIN para executar este procedimento.

Sintaxe

DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK(
    task_name          IN VARCHAR2,
    hostname           IN VARCHAR2,
    port               IN VARCHAR2,
    service_name       IN VARCHAR2,
    credential_name    IN VARCHAR2,
    directory_name     IN VARCHAR2,
    ssl_server_cert_dn IN VARCHAR2 DEFAULT NULL,
    gateway_params     IN VARCHAR2 DEFAULT NULL,
    schema_list        IN CLOB     DEFAULT NULL,
    table_list         IN CLOB     DEFAULT NULL
);

Parâmetros

Parâmetro Descrição

task_name

Identifica exclusivamente a tarefa de importação. Este é o nome atribuído à tarefa de migração. Ele é usado para identificar a tarefa e seu job de scheduler associado.

hostname

O nome de host do banco de dados de destino.

Não é permitido especificar localhost para hostname.

port

Especifica a porta das conexões com o banco de dados de destino.

Quando você especificar uma conexão com conectividade heterogênea gerenciada pelo sistema Oracle usando o parâmetro gateway_params, defina a porta com base no valor db_type.

Consulte Tipos e Portas de Banco de Dados de Conectividade Heterogênea Gerenciada pela Oracle para obter mais informações.

service_name

O service_name para o qual o banco de dados será vinculado. Para um Autonomous AI Database de destino, localize o nome do serviço por um dos seguintes métodos:

  • Procure no arquivo tnsnames.ora no wallet.zip que você faz download de um Autonomous AI Database para sua conexão.

  • Clique em Conexão do banco de dados na Console do Oracle Cloud Infrastructure. Na área Strings de Conexão, cada string de conexão inclui uma entrada service_name com a string de conexão para o serviço correspondente. Quando conexões TLS Mútuas (mTLS) e TLS forem permitidas, em autenticação TLS, selecione TLS para exibir os nomes TNS e as strings de conexão para conexões com autenticação TLS. Consulte Exibir Nomes TNS e Strings de Conexão para uma Instância do Autonomous AI Database para obter mais informações.

  • Consulte a exibição V$SERVICES. Por exemplo: 

    SELECT name FROM V$SERVICES;

    Quando você especifica uma conexão com a conectividade heterogênea gerenciada pela Oracle usando o parâmetro gateway_params, o service_name é o nome do banco de dados não Oracle.

credential_name

O nome de uma credencial armazenada criada com DBMS_CLOUD.CREATE_CREDENTIAL. Estas são as credenciais para acessar o banco de dados de origem.

directory_name

O diretório do arquivo cwallet.sso. O valor padrão para esse parâmetro é 'data_pump_dir'.

A conectividade heterogênea gerenciada pela Oracle é pré-configurada com uma wallet que contém a maioria dos certificados SSL raiz e intermediários confiáveis comuns. O parâmetro directory_name não é obrigatório quando você fornece o parâmetro gateway_params.

ssl_server_cert_dn

O valor DN encontrado no certificado do servidor.

A conectividade heterogênea gerenciada pela Oracle é pré-configurada com uma wallet que contém a maioria dos certificados SSL raiz e intermediários confiáveis comuns. O parâmetro ssl_server_cert_dn deve ser NULL quando você fornece o parâmetro gateway_params ou não inclui o parâmetro ssl_server_cert_dn (o valor padrão é NULL).

gateway_params

Especifica definições de conexão e tipo de origem usadas para migrações heterogêneas (ou seja, quando a origem é um banco de dados não Oracle).

Ele é informado como um objeto JSON e inclui valores como o tipo de banco de dados de origem, por exemplo:gateway_params => JSON_OBJECT('db_type' VALUE 'mysql').

Esses parâmetros informam ao job de migração qual comportamento de gateway ou driver usar ao estabelecer conexão e importar dados do sistema de origem. Esse parâmetro é opcional e tem como padrão NULL.

schema_list

Lista de esquemas a serem incluídos na importação.

Esse parâmetro é opcional. Se você não especificar um valor, o padrão será NULL, todos os esquemas no banco de dados de origem serão migrados.

table_list

Especifica as tabelas a serem migradas como um array JSON de entradas '[{"schema_name":"public","table_name":"sales_data"}]'.

Use table_list para executar uma migração no nível da tabela (parcial), somente as tabelas especificadas são migradas.

Não especifique objetos sobrepostos em schema_list e table_list. Esse parâmetro só é suportado quando o banco de dados de origem é Oracle.

Esse parâmetro é opcional e tem como padrão NULL.

Exemplo

BEGIN
  DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK(
    task_name          => 'orcl_import_job',
    hostname           => '<remote_db_hostname>',
    port               => '<remote_db_port>',
    service_name       => '<remote_db_service_name>',
    ssl_server_cert_dn => '<cn=remote_db_cn_name>',
    directory_name     => '<walletdb>',
    credential_name    => 'db1_cred',
    schema_list        => '["admin"]'
  );
END;
/

Procedimento SUSPEND_IMPORT_TASK

O procedimento DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK pausa temporariamente uma tarefa de importação em execução, permitindo que ela seja retomada posteriormente.

Sintaxe

DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parâmetros

Parâmetro Descrição

task_name

Identifica exclusivamente a tarefa de importação.

Exemplo

BEGIN
  DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK(
   task_name => 'SALES_IMPORT_JOB1'
);
END;
/

Procedimento RESUME_IMPORT_TASK

O procedimento DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK retoma uma tarefa de importação que foi suspensa anteriormente. Ele reinicia a execução da tarefa para o task_name especificado e continua a operação de importação do ponto em que foi pausada.

Você deve estar conectado como o usuário ADMIN para executar este procedimento.

Sintaxe

DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parâmetros

Parâmetro Descrição

task_name

Identifica exclusivamente a tarefa de importação.

Exemplo

BEGIN
  DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK(
   task_name => 'SALES_IMPORT_JOB1'
  );
 END;
/

Procedimento DROP_IMPORT_TASK

O procedimento DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK exclui uma tarefa de importação e remove sua definição e metadados de tarefa associados.

Você deve estar conectado como o usuário ADMIN para executar este procedimento.

Sintaxe

DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parâmetros

Parâmetro Descrição

task_name

Identifica exclusivamente a tarefa de importação.

Exemplo

BEGIN
  DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK(
   task_name => 'SALES_IMPORT_JOB1'
  );
 END;
/