Documentación de Oracle Cloud Infrastructure

Paquete DBMS_CLOUD_IMPORT

DBMS_CLOUD_IMPORT facilita la importación de datos de bases de datos Oracle, así como de bases de datos que no son de Oracle, mediante el gateway heterogéneo de Oracle en la base de datos de IA autónoma. Durante el proceso de importación, los tipos de dato de origen se convierten en tipos de dato compatibles con Oracle. Como resultado, las limitaciones y restricciones del gateway heterogéneo de Oracle también se aplican a las operaciones realizadas a través de este paquete.

Tema principal: Referencia de paquete proporcionado de base de datos de IA autónoma

Resumen de subprogramas DBMS_CLOUD_IMPORT

En esta tabla se resumen los subprogramas incluidos DBMS_CLOUD_IMPORT en el paquete.

Subprograma Descripción

Procedimiento ADD_BY_LIKE

Crea una tarea de importación para importar datos de un origen especificado a Oracle, con filtros opcionales por esquema o tabla y opciones de programación configurables.

Procedimiento ADD_FILE

Permite pausar temporalmente una tarea de importación en ejecución para que se pueda reanudar más tarde.

Procedimiento ADD_LATEST_FILES

Reinicia una tarea de importación suspendida anteriormente y continúa el procesamiento desde el momento en que se pausó.

Procedimiento ADD_TABLE

Suprime una tarea de importación y elimina sus metadatos y definición de tarea asociados.
  • Procedimiento CREATE_IMPORT_TASK
    El procedimiento DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK crea y configura un trabajo de importación para importar datos de un sistema de origen especificado a una base de datos de IA autónoma.
  • Procedimiento SUSPEND_IMPORT_TASK
    El procedimiento DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK pausa temporalmente una tarea de importación en ejecución, lo que permite que se reanude más tarde.
  • Procedimiento RESUME_IMPORT_TASK
    El procedimiento DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK reanuda una tarea de importación que se suspendió anteriormente. Reinicia la ejecución de la tarea para el task_name especificado y continúa la operación de importación desde el punto en que se pausó.
  • Procedimiento DROP_IMPORT_TASK
    El procedimiento DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK suprime una tarea de importación y elimina sus metadatos y definición de tarea asociados.

Tema principal: Paquete DBMS_CLOUD_IMPORT

Procedimiento CREATE_IMPORT_TASK

El procedimiento DBMS_CLOUD_IMPORT.CREATE_IMPORT_TASK crea y configura un trabajo de importación para importar datos de un sistema de origen especificado a una base de datos de IA autónoma.

Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN.

Sintaxis

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 Descripción

task_name

Identifica de manera única la tarea de importación. Este es el nombre asignado a la tarea de migración. Se utiliza para identificar la tarea y su trabajo de programador asociado.

hostname

Nombre de host de la base de datos de destino.

No se permite especificar localhost para hostname.

port

Especifica el puerto para las conexiones a la base de datos destino.

Al especificar una conexión con una conectividad heterogénea gestionada por Oracle mediante el parámetro gateway_params, defina el puerto según el valor db_type.

Consulte Tipos y puertos de bases de datos de conectividad heterogénea gestionada por Oracle para obtener más información.

service_name

service_name para la base de datos a la que enlazar. Para una base de datos de IA autónoma de destino, busque el nombre del servicio mediante uno de los siguientes métodos:

  • Busque en el archivo tnsnames.ora de wallet.zip que descargue de una base de datos de IA autónoma para su conexión.

  • Haga clic en Conexión de base de datos en la consola de Oracle Cloud Infrastructure. En el área Cadenas de conexión, cada cadena de conexión incluye una entrada service_name con la cadena de conexión para el servicio correspondiente. Cuando se permiten conexiones TLS mutuas (mTLS) y TLS, en autenticación TLS, seleccione TLS para ver los nombres de TNS y las cadenas de conexión para las conexiones con autenticación TLS. Consulte Visualización de nombres TNS y cadenas de conexión para una instancia de base de datos de IA autónoma para obtener más información.

  • Consulte la vista V$SERVICES. Por ejemplo: 

    SELECT name FROM V$SERVICES;

    Al especificar una conexión con una conectividad heterogénea gestionada por Oracle mediante el parámetro gateway_params, service_name es el nombre de la base de datos que no es de Oracle.

credential_name

Nombre de una credencial almacenada creada con DBMS_CLOUD.CREATE_CREDENTIAL. Se trata de las credenciales para acceder a la base de datos origen.

directory_name

Directorio para el archivo cwallet.sso. El valor por defecto para este parámetro es 'data_pump_dir'.

La conectividad heterogénea gestionada por Oracle está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y raíz de confianza comunes. El parámetro directory_name no es necesario al proporcionar el parámetro gateway_params.

ssl_server_cert_dn

Valor de DN encontrado en el certificado del servidor.

La conectividad heterogénea gestionada por Oracle está preconfigurada con una cartera que contiene la mayoría de los certificados SSL intermedios y raíz de confianza comunes. ssl_server_cert_dn debe ser NULL al proporcionar el parámetro gateway_params o al no incluir el parámetro ssl_server_cert_dn (el valor por defecto es NULL).

gateway_params

Especifica los valores de conexión y tipo de origen utilizados para migraciones heterogéneas (es decir, cuando el origen es una base de datos que no es de Oracle).

Se transfiere como un objeto JSON e incluye valores como el tipo de base de datos de origen, por ejemplo:gateway_params => JSON_OBJECT('db_type' VALUE 'mysql').

Estos parámetros indican al trabajo de migración qué comportamiento del gateway o del controlador se debe utilizar al conectarse al sistema de origen e importar datos desde él. Este parámetro es opcional y se define por defecto en NULL.

schema_list

Lista de esquemas que se deben incluir en la importación.

Este parámetro es opcional. Si no especifica un valor, el valor por defecto es NULL, todos los esquemas de la base de datos de origen se migran.

table_list

Especifica las tablas que se van a migrar como una matriz JSON de entradas '[{"schema_name":"public","table_name":"sales_data"}]'.

Utilice table_list para realizar una migración a nivel de tabla (parcial), solo se migran las tablas especificadas.

No especifique objetos superpuestos en schema_list y table_list. Este parámetro solo está soportado cuando la base de datos origen es Oracle.

Este parámetro es opcional y se define por defecto en NULL.

Ejemplo

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;
/

Procedimiento SUSPEND_IMPORT_TASK

El procedimiento DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK pausa temporalmente una tarea de importación en ejecución, lo que permite que se reanude más tarde.

Sintaxis

DBMS_CLOUD_IMPORT.SUSPEND_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parámetros

Parámetro Descripción

task_name

Identifica de manera única la tarea de importación.

Ejemplo

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

Procedimiento RESUME_IMPORT_TASK

El procedimiento DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK reanuda una tarea de importación que se suspendió anteriormente. Reinicia la ejecución de la tarea para el task_name especificado y continúa la operación de importación desde el punto en que se pausó.

Debe estar conectado como usuario ADMIN para ejecutar este procedimiento.

Sintaxis

DBMS_CLOUD_IMPORT.RESUME_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parámetros

Parámetro Descripción

task_name

Identifica de manera única la tarea de importación.

Ejemplo

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

Procedimiento DROP_IMPORT_TASK

El procedimiento DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK suprime una tarea de importación y elimina sus metadatos y definición de tarea asociados.

Para ejecutar este procedimiento, debe estar conectado como usuario ADMIN.

Sintaxis

DBMS_CLOUD_IMPORT.DROP_IMPORT_TASK(
   task_name IN VARCHAR2 );

Parámetros

Parámetro Descripción

task_name

Identifica de manera única la tarea de importación.

Ejemplo

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