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.

Resumo dos Subprogramas DBMS_CLOUD_IMPORT

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

Subprograma Descrição
Procedimento CREATE_IMPORT_TASK 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 SUSPEND_IMPORT_TASK Pausa temporariamente uma tarefa de importação em execução para que ela possa ser retomada posteriormente.
Procedimento RESUME_IMPORT_TASK Reinicia uma tarefa de importação suspensa anteriormente e continua o processamento a partir do ponto em que foi pausada.
Procedimento DROP_IMPORT_TASK 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.

Você deve estar conectado como 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 no arquivo tnsnames.ora na wallet, nas strings de conexão na Console do Oracle Cloud Infrastructure ou consultando a view V$SERVICES. Consulte Exibir Nomes TNS e Strings de Conexão para uma Instância do Autonomous AI Database para obter mais informações. 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. Esta é a credencial para acessar o banco de dados de origem.
directory_name O diretório do arquivo cwallet.sso. O valor padrão para este 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ê fornecer o parâmetro gateway_params ou não incluir 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, 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 parcial no nível da tabela. 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 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 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;
/