Documentación de Oracle Cloud Infrastructure

Selección del destino de una tarea del cargador de datos

Seleccione el activo de datos, la conexión y el esquema que desea utilizar como destino. A continuación, configure una nueva entidad de destino o seleccione una entidad de datos existente en la que cargar los datos.

Selección de un Activo de Datos de Destino, Conexión y Esquema

Para configurar la entidad de datos de destino para una tarea del cargador de datos, primero debe seleccionar un activo de datos, una conexión y un esquema.

Puede parametrizar los recursos después de realizar las selecciones.

  1. En la página Create data loader task, vaya al paso Target.
  2. Para crear y seleccionar el activo de datos para este destino, seleccione Crear junto al activo de datos para crear un activo de datos.
  3. Para seleccionar una entidad de datos de destino de un activo de datos existente, utilice primero los menús para seleccionar el activo de datos, la conexión y el esquema (o cubo) solo en el orden en el que se muestran. Observe lo siguiente:

    • Los recursos de activo de datos disponibles para la selección dependen del tipo de destino seleccionado en el paso Información fundamental. Seleccione Ver todo junto a un recurso si es que no encuentra lo que desea en el menú de recursos.

    • Si se aplica a un activo de datos (por ejemplo, Object Storage), seleccione un compartimento antes de seleccionar un cubo (esquema).

    • En el caso de una conexión a base de datos, puede seleccionar Agregar para crear y agregar la conexión.

  4. (Opcional) Puede asignar un parámetro al activo de datos, la conexión y el esquema después de realizar selecciones para los recursos. Realice una de las siguientes acciones para un recurso en el destino:
    • Seleccione Parámetroizar junto al recurso para asignar un parámetro a ese recurso. Tras la parametrización, Data Integration agrega un parámetro del tipo adecuado y define el valor de parámetro por defecto en el valor que está configurado actualmente para ese recurso.
    • Si está disponible, seleccione Volver a utilizar el parámetro <resource> de origen para utilizar el mismo parámetro que se ha agregado al recurso del mismo tipo en el origen. Para obtener más información, consulte Reutilización de parámetros para recursos de origen o destino.

    Tenga en cuenta que cuando el tipo de activo de datos es Object Storage, puede parametrizar el cubo (esquema), pero no el compartimento que contiene el cubo.

  5. En función del tipo de activo de datos del destino, puede que tenga otras opciones que seleccionar.
    Tipo de activo de datos Opción

    Almacenamiento de objetos, HDFS

    En Configuración de archivo, seleccione el tipo de archivo y el tipo de compresión, así como la codificación, si procede. Los tipos de compresión que están disponibles para la selección dependen del tipo de archivo.

    Para CSV, los otros valores que puede configurar son:

    • Si todos los archivos tienen una primera fila como cabecera, seleccione Los datos tienen cabecera.
    • Si los valores de las filas de datos abarcan varias líneas, seleccione Multi línea.
    • Especifique el carácter de escape que escapa a otros caracteres encontrados en los valores de datos. Por ejemplo: \
    • Seleccione el carácter Delimitador que separa los campos de datos. Por ejemplo: COLON (:), COMMA (,), PIPE (|), SEMICOLON (;) o TAB (\t)
    • Especifique el carácter de oferta que trata a otros caracteres como caracteres literales. Por ejemplo: "
    • Si un delimitador de columna se incluye al final de una fila de datos en todos los archivos, seleccione Delimitador final.

    Lo siguiente solo está disponible cuando ha seleccionado Usar entidad de datos existente en Configuración de carga de entidades de datos de destino: para archivos JSON, seleccione Usar esquema personalizado si desea pegar o cargar un esquema de ejemplo personalizado que se utilice para inferir la unidad de entidad.

    • Si selecciona Cargar, suelte un archivo de esquema personalizado en el cuadro proporcionado o haga clic en Seleccionar un archivo para seleccionar el archivo de esquema que desea cargar.

    • Si selecciona Pegar en esquema, copie el contenido del archivo de texto de esquema y péguelo en el cuadro proporcionado.

    Autonomous Data Warehouse, Autonomous Transaction Processing

    • Si el activo de datos que selecciona está configurado con una ubicación temporal por defecto, Data Integration utiliza automáticamente ese cubo de Object Storage para la ubicación temporal. Use la ubicación temporal por defecto configurada para el activo de datos o especifique otra ubicación temporal.

      Para utilizar una ubicación temporal diferente, en Staging location, desactive la casilla de control Use default staging location settings. A continuación, utilice los menús del recurso para seleccionar un activo de datos de Object Storage, una conexión, un compartimento y, por último, el cubo (esquema) que se va a utilizar para la ubicación temporal.

    • Si el activo de datos que selecciona no tiene una ubicación temporal por defecto configurada, utilice los menús del recurso para seleccionar un activo de datos de Object Storage, una conexión, un compartimento y, a continuación, el cubo (esquema) que se va a utilizar para la ubicación temporal.
Después de seleccionar el activo de datos, la conexión, el esquema (o el cubo) y las opciones de destino aplicables, configure los valores de carga de destino para una nueva entidad de datos o entidad de datos existente.
Uso de nuevas entidades de datos de destino

Data Integration puede crear nuevas entidades de datos de destino al cargar datos de las entidades de origen.

Para el tipo de carga de entidad de datos única, puede utilizar un parámetro para la entidad de datos solo si selecciona la opción para introducir un nombre de entidad de datos.

  1. Vaya al paso Destino, separador Entidades de datos.
  2. En Configuración de carga de entidades de datos de destino, seleccione Crear nueva entidad de datos.

    Para un nuevo destino, la estrategia de integración siempre es Insertar.

  3. Solo para el destino de Object Storage: seleccione la casilla de control Crear salida como un solo archivo si desea utilizar un solo archivo de salida. De lo contrario, se crean varios archivos.

    El único archivo de salida se sobrescribe cada vez que se ejecuta la tarea. La creación de un único archivo de salida podría afectar al rendimiento de Data Integration. No utilice la opción de archivo de salida único para juegos de datos grandes.

    Para el tipo de carga de varias entidades de datos, cada nueva entidad del destino tiene un único archivo correspondiente.

  4. Especifique la opción Nombre de entidad de datos de destino que desee para el nuevo destino. Puede elegir entre:

    • Usar mismos nombres de entidad como origen: seleccione esta opción para crear entidades de destino con los mismos nombres que las entidades de origen.

    • Agregar Prefijo/Suffix: seleccione esta opción para agregar una cadena al inicio (prefix) o al final (suffix) de los nombres de entidad de origen para crear los nombres de entidad de destino.

    • (Solo para un tipo de carga de entidad única) Especificar nombre de entidad: introduzca el nuevo nombre de entidad de destino en el campo.

      • Para Object Storage: introduzca el nuevo nombre de la entidad de datos, seguido de una barra (/). Por ejemplo, introduzca newfile/ o newdirectory/newfile/. Sin embargo, si selecciona la casilla de control Crear salida como un único archivo porque desea crear una única salida de archivo, introduzca el nuevo nombre de entidad sin la barra (/) al final.

      • Para un destino de base de datos: si el nombre de entidad que proporciona existe, el resultado de la operación depende de la unidad del destino de la tarea del cargador de datos y la forma de la entidad existente.

  5. (Opcional) (Solo para tipo de carga de entidad única) Puede asignar un parámetro a la entidad de datos solo si ha seleccionado introducir un nombre de entidad de datos en el paso anterior. Realice una de las siguientes acciones:
    • Seleccione Parámetroizar junto al recurso para asignar un parámetro a ese recurso. Tras la parametrización, Data Integration agrega un parámetro del tipo adecuado y define el valor de parámetro por defecto en el valor que está configurado actualmente para ese recurso.
    • Si está disponible, seleccione Reutilizar parámetro de entidad de datos de origen para utilizar el parámetro de entidad de origen como parámetro para esta entidad de datos de destino. Para obtener más información, consulte Reutilización de parámetros para recursos de origen o destino.
  6. Si corresponde, seleccione el separador Settings (Configuración) e introduzca un valor para Reject limit.

    En Autonomous Data Warehouse o Autonomous Transaction Processing:

    Puede especificar el número máximo de filas erróneas que no se pueden cargar en el destino antes de que falle la tarea. Por ejemplo, si el origen de datos tiene 1.000 filas y se define el límite de rechazo en 200, la tarea falla inmediatamente después de que se rechaza la fila errónea número 200.

    Si no especifica un valor, el valor por defecto es cero, lo que significa que la tarea falla cuando se rechaza la primera fila errónea.

    Si se produce un fallo de tarea, compruebe en los logs los nombres de tabla en los que se han rechazado las filas. A continuación, consulte las tablas y filas afectadas en la base de datos autónoma.

Uso de entidades de datos de destino existentes

Al utilizar entidades de datos de destino existentes, seleccione la estrategia de integración que determina cómo cargar datos en el destino existente.

Para un tipo de carga de entidad de datos único, puede utilizar un parámetro para la entidad de datos después de seleccionar una entidad de datos.

  1. Vaya al paso Destino, separador Entidades de datos.
  2. En Configuración de carga de entidades de datos de destino, seleccione Usar entidad de datos existente.
  3. Para especificar cómo cargar datos en el destino, seleccione una de las opciones de estrategia de integración disponibles.

    • Insertar: inserta nuevos registros o agrega los registros cuando existen datos en el destino.

    • Sobrescribir: trunca el destino antes de insertar nuevos registros.

      La estrategia de integración debe ser Overwrite si desea crear una salida como un único archivo para el destino de Object Storage.

    • Fusionar: inserta nuevos registros y fusiona los existentes. La estrategia de fusión solo está disponible para destinos de base de datos.

      Para el tipo de carga de entidad de datos única (consulte el paso 5), tiene la opción de seleccionar una clave única que no sea la clave primaria para fusionar los datos.

      Para el tipo de carga Varias entidades de datos, se utiliza la clave primaria por defecto. No es necesaria ninguna otra acción o selección.

  4. Para la estrategia de sobrescritura y el destino de Object Storage únicamente: seleccione la casilla de control Crear salida como un solo archivo si desea utilizar un solo archivo de salida. De lo contrario, se crean varios archivos.

    El único archivo de salida se sobrescribe cada vez que se ejecuta la tarea. La creación de un único archivo de salida podría afectar al rendimiento de Data Integration. No utilice la opción de archivo de salida único para juegos de datos grandes.

    Para el tipo de carga de varias entidades de datos, cada entidad seleccionada en el destino tiene un único archivo correspondiente.

  5. En el tipo de carga Única entidad de datos:
    1. En la tabla Entidades de datos disponibles, seleccione una entidad de datos. Por ejemplo:

      • Seleccione la casilla de control que está junto a un nombre de entidad y, a continuación, seleccione Definir como destino.

      • Filtre la lista introduciendo un nombre o un patrón en el campo y pulsando Intro.

        Puede introducir un nombre parcial o un patrón con caracteres especiales como *. Por ejemplo, puede introducir ADDRESS_* para encontrar ADDRESS_EU1, ADDRESS_EU2 y ADDRESS_EU3.

        En la lista filtrada, seleccione la casilla de control que está junto a un nombre de entidad y, a continuación, seleccione Definir como destino.

      • Para un destino de Object Storage con la estrategia de integración Sobrescribir, seleccione una entidad de datos existente que no tenga la barra inclinada (/) al final del nombre de la entidad.
      El nombre de la entidad que seleccione se muestra junto a la etiqueta Entidad del dato seleccionada. Para seleccionar una entidad de datos diferente para utilizar como destino, seleccione Eliminar y, a continuación, seleccione la entidad en la tabla Entidades de datos disponibles.
    2. (Opcional) Puede asignar un parámetro a la entidad de datos después de haber seleccionado una entidad de datos en el paso anterior. Realice una de las siguientes acciones:
      • Seleccione Parámetroizar junto al recurso para asignar un parámetro a ese recurso. Tras la parametrización, Data Integration agrega un parámetro del tipo adecuado y define el valor de parámetro por defecto en el valor que está configurado actualmente para ese recurso.
      • Si está disponible, seleccione Reutilizar parámetro de entidad de datos de origen para utilizar el parámetro de entidad de origen como parámetro para esta entidad de datos de destino. Para obtener más información, consulte Reutilización de parámetros para recursos de origen o destino.
    3. (Opcional) Para un destino de base de datos con la estrategia de integración Fusionar:

      La clave de fusión identifica el atributo o los atributos para determinar las filas existentes o nuevas que se van a actualizar o insertar. Puede seleccionar una clave primaria/única o una clave no primaria como clave de fusión.

      Haga clic en Seleccionar o Editar. En el panel Clave de fusión, realice una de las siguientes acciones:

      • Seleccione Atributos de clave principal/única y seleccione una clave.
      • Seleccione Otros atributos para utilizar otros atributos (no principales). Introduzca un nombre para la clave de fusión y seleccione los atributos de la lista.
  6. Para el tipo de carga Varias entidades de datos: por defecto, las entidades de datos de origen se asignan automáticamente a las entidades de datos de destino disponibles por nombre.
    1. En la tabla Entidades de datos de origen, columna Asignación, puede colocar el cursor sobre una asignación que tenga una marca de verificación verde para ver el nombre de entidad de destino asignado.
    2. Para crear una asignación manual, arrastre la entidad de datos de origen a la entidad de datos de destino. Se agrega una regla de asignación al realizar una asignación manual.
    3. Para eliminar una asignación automática o manual, en la columna Asignación de la tabla Entidades de datos de destino, seleccione Borrar junto a una asignación. A continuación, seleccione Borrar asignación para confirmar que desea eliminar la asignación. Se agrega una regla de asignación al borrar una asignación.
    4. En la tabla entidades de datos de origen o entidades de datos de destino, puede:

      • Filtre la lista introduciendo un nombre o un patrón en el campo y pulsando Intro.

        Puede introducir un nombre parcial o un patrón con caracteres especiales como *. Por ejemplo, puede introducir ADDRESS_* para encontrar ADDRESS_EU1, ADDRESS_EU2 y ADDRESS_EU3.

      • Ver todas las entidades, entidades asignadas o entidades no asignadas, seleccionando la opción adecuada en el menú situado encima de la tabla.

    5. En el menú Acciones, puede seleccionar:

      • Asignación automática por nombre: utilice esta acción para permitir que Data Integration cree automáticamente asignaciones entre entidades de origen y entidades de destino por nombre.

      • Map by pattern: utilice esta acción para definir un patrón de origen y un patrón de destino para asignar entidades de origen a entidades de destino. La coincidencia de patrón es sensible a mayúsculas/minúsculas.

        Consulte Asignación por patrón.

    Para gestionar reglas de asignación, consulte Visualización y eliminación de reglas de asignación.
Visualización y eliminación de reglas de asignación (varias entidades de datos de destino)

Data Integration agrega reglas de asignación cuando asigna manualmente entidades de datos de origen a entidades de datos de destino existentes para una tarea del cargador de datos.

Las reglas también se agregan al eliminar asignaciones.

  1. Vaya al paso Destino, separador Entidades de datos.
  2. Para mostrar las reglas creadas para una tarea de cargador datos, seleccione Ver asignaciones.
  3. En el panel Reglas de asignación de entidades, revise las asignaciones que ha creado.
  4. Para eliminar una regla de asignación, puede utilizar uno de los dos métodos siguientes:

    • Seleccione la casilla de control de una regla y, a continuación, seleccione Eliminar.

    • Seleccione el menú Acciones (Acciones, menú) para una regla y, a continuación, seleccione Suprimir.