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.

Resumen de subprogramas DBMS_CLOUD_IMPORT

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

Subprograma Descripción
Procedimiento CREATE_IMPORT_TASK 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 SUSPEND_IMPORT_TASK Permite pausar temporalmente una tarea de importación en ejecución para que se pueda reanudar más tarde.
Procedimiento RESUME_IMPORT_TASK Reinicia una tarea de importación suspendida anteriormente y continúa el procesamiento desde el momento en que se pausó.
Procedimiento DROP_IMPORT_TASK 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.

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 en el archivo tnsnames.ora de la cartera, en las cadenas de conexión de la consola de Oracle Cloud Infrastructure o consultando la vista V$SERVICES. 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. 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. Credencial para acceder a la base de datos origen.
directory_name Directorio para el archivo cwallet.sso. El valor predeterminado de 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, 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 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 parcial a nivel de tabla, 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ó.

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

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