Documentación de Oracle Cloud Infrastructure

Trabajar con entidades de datos

Una entidad de datos es una representación tabular de una estructura de datos.

Incluye tablas o vistas de base de datos que se pueden utilizar en una asignación como origen o destino. Son simplemente los metadatos de orígenes y destinos. Se utilizan para crear flujos de datos.

Puede agregar entidades de datos al proyecto recién creado de una de estas dos formas:

Todas las entidades de datos recién creadas o importadas, junto con sus detalles, se muestran en la página Entidades de datos. Los detalles incluyen:

  • Nombre de la entidad de datos
  • Conexión para la que se ha creado la entidad de datos
  • Esquema al que está asociada la entidad de datos
  • Haga clic en el icono Acciones (Icono Acciones) junto a la entidad de datos seleccionada para realizar las siguientes operaciones:
    • Seleccione Editar para editar los detalles existentes.
    • Seleccione Vista previa para obtener una vista previa de la entidad de datos seleccionada. Si la entidad de datos pertenece a una base de datos Oracle, también puede ver las estadísticas de la tabla. Consulte Visualización de estadísticas de entidades de datos para obtener más información.
    • Seleccione Suprimir para suprimir la entidad de datos seleccionada.
  • Para suprimir las entidades de datos de forma masiva, en la página Entidades de datos, seleccione las casillas de control de las entidades de datos respectivas y haga clic en Suprimir.
  • También puede buscar la entidad de datos necesaria para conocer sus detalles según los siguientes filtros:
    • Nombre de la entidad de datos
    • Conexión para la que se ha creado la entidad de datos
    • Esquema al que está asociada la entidad de datos
    • Etiqueta asociada a la entidad de datos

Tema principal: Página Data Transforms

Importar entidades de datos

La forma más sencilla y común de crear una entidad de datos es importando su estructura del tipo de conexión (por ejemplo, la base de datos Oracle).

Para importar entidades de datos existentes:

  1. En el panel izquierdo de la página inicial, haga clic en el separador Entidades de datos.

    Aparece la página Entidades de datos.

  2. Haga clic en Importar entidades de datos para importar las entidades de datos existentes.

    En las diapositivas de la página Importar entidades de datos.

  3. Seleccione la conexión seguida del esema y, a continuación, seleccione finalmente el tipo de objetos que desea importar. Para las conexiones de Oracle Object Storage, en la lista desplegable Esquema se muestra el nombre del cubo especificado en la URL al crear la conexión.
  4. [Sólo para conexiones de Oracle Business Intelligence Cloud Connector (BICC)] En Ofertas que importar para recopilación, seleccione las ofertas cuyos almacenes de datos desea importar. Debe seleccionar al menos una oferta para importar los objetos de vista pública (PVO) de BICC.
    Nota

    La importación de PVO de BICC puede tardar mucho tiempo en función del número de objetos seleccionados. Para mejorar el rendimiento, Oracle recomienda utilizar una máscara para filtrar y limitar el número de PVO que desea importar.
  5. Seleccione una máscara/filtro si no desea importar todos los objetos del esquema.

    Según el tipo de conexión, se le presentarán otras opciones de importación.

    Nota

    Para las conexiones de Oracle Object Storage, este valor se distingue entre mayúsculas y minúsculas. Si Archivos similares por lotes está definido en True, todos los archivos que coincidan con la máscara y que tengan la misma estructura se agrupan en una única entidad de datos.
  6. [Solo para conexiones de Oracle Financials Cloud] En la lista de la sección Recursos, seleccione los elementos que desea importar. Cuando se completa el proceso de importación, se crea una tabla para cada recurso seleccionado.
  7. [Solo para conexiones de servidor REST] En la sección Recursos, realice lo siguiente:
    • En el campo URI de recurso, introduzca la URL del servicio REST desde el que desea importar recursos.
    • Haga clic en el icono +.
    • En la columna Nombre, introduzca un identificador para el recurso.
    • En la columna URI de operación, introduzca el URI del recurso.
    • Haga clic en Probar recurso para comprobar si las entradas son válidas.
  8. Haga clic en Iniciar.

    Se crea un trabajo y se muestra el ID de trabajo correspondiente para que pueda realizar un seguimiento de la sesión. Haga clic en el ID de trabajo para ver los detalles de este.

    Tras la ejecución correcta del trabajo, se importan todas las entidades de datos seleccionadas. Haga clic en el icono Refresh Actualizar situado en la esquina derecha de la página Data Entities para ver las nuevas entidades de datos importadas.

Crear entidades de datos

Puede crear o actualizar manualmente las entidades de datos mediante la interfaz de Oracle Data Transforms.

Las entidades de datos deben tener los objetos correspondientes en la conexión de origen para utilizarlos como origen en un flujo de datos. Normalmente, el proceso de importación garantiza que estos objetos estén coordinados. Sin embargo, siempre que cree o actualice manualmente entidades de datos, siempre asegúrese de comprobar si ambas definiciones están coordinadas entre sí.

Al utilizar una entidad de datos como destino, no tiene que existir previamente en la conexión de destino y se puede crear como parte de la ejecución de Data Flow.

Para crear una nueva entidad de datos:
  1. En el panel izquierdo de la página inicial, haga clic en el separador Entidades de datos.

    Aparece la página Entidades de datos.

  2. Haga clic en Crear entidad de datos para crear una nueva entidad de datos.

    Aparece la página Crear entidad de datos.

  3. En el cuadro de texto Nombre, introduzca el nombre de la nueva entidad de datos que está creando.
  4. En la lista desplegable Conexión, seleccione la conexión necesaria desde la que desea agregar la entidad de datos recién creada.
    Nota

    Las conexiones de Oracle Financials Cloud no se muestran aquí porque no puede crear manualmente entidades de datos para dichas conexiones. Solo puede importar entidades de datos desde puntos finales REST de Oracle Financials Cloud mediante la página Importar entidades de datos. Consulte Importación de entidades de datos.
  5. En la lista desplegable Esquema, todos los esquemas correspondientes a la conexión seleccionada se muestran en dos grupos.
    • Nuevo esquema de base de datos (uno que no haya importado anteriormente) y
    • Esquema de base de datos existente (un esquema que ha importado anteriormente y que puede sustituir entidades de datos).

    En la lista desplegable Plan, seleccione el esquema necesario.

    Nota

    Para las conexiones de Oracle Object Storage, en la lista desplegable Esquema se muestra el nombre del cubo especificado en la URL al crear la conexión.
  6. En la lista desplegable Tipo, seleccione el tipo de entidad de datos.
    • Tabla: para definir la estructura de tabla para la entidad de datos recién creada, haga clic en el icono + para agregar columnas. Para cada columna, puede especificar parámetros como Nombre, Tipo de datos, Longitud, Escala, No nulo. Haga doble clic en la celda para configurar el valor.

      Haga clic en el icono de la 'x' para suprimir una fila. Haga clic en las flechas arriba y abajo para ordenar las filas de la tabla.

    • Vista en línea: para crear la entidad de datos mediante el código en línea, introduzca la sentencia Select en el separador Consulta. Por ejemplo, SELECT * FROM CUSTOMER. Haga clic en Validar.

      El separador Columnas muestra una lista de solo lectura de las columnas que devuelve la consulta. Haga clic en el separador Vista previa para ver los datos de columna.

  7. En el cuadro de texto Etiquetas, introduzca una etiqueta de su elección. Puede utilizar etiquetas para filtrar las entidades de datos que se muestran en la página Entidad de datos.
  8. Para las conexiones de Oracle Object Storage, en esta página se muestran las siguientes opciones:
    • Contenido: seleccione el archivo CSV que contiene los datos que desea importar. Los metadatos que se muestran en la tabla de vista previa, como el tipo de datos y la longitud de las columnas, se basan en la primera fila del archivo CSV. Asegúrese de que el archivo CSV tenga una línea de cabecera. La cabecera solo puede contener caracteres alfanuméricos y no caracteres especiales.
    • Agrupar archivos: seleccione esta casilla de control si desea agrupar datos de varios archivos CSV en una entidad de datos. Por ejemplo, supongamos que desea fusionar datos de Employee_Data1.csv, Employee_Data2.csv y Employee_Data3.csv en una única entidad de datos.

      Si desea cargar los archivos CSV con Windows, asegúrese de convertir primero los archivos a formato Unix para evitar problemas de codificación de caracteres durante la agrupación.

    • Nombre de recurso: utilice esta opción junto con Group Files. Introduzca el valor que desea usar para identificar los archivos. El nombre del recurso debe ser una expresión regular. Solo puede utilizar un asterisco (*) como carácter comodín en el nombre del recurso. Por ejemplo, Employee_Data*.csv.
  9. Para las conexiones de base de datos Oracle, puede marcar las entidades de datos como un grupo de funciones. Amplíe Opciones avanzadas y haga clic en la casilla de control Grupo de características.
  10. Haga clic en Guardar.

    Se crea la nueva entidad de datos.

Creación de entidades de datos en el editor de Data Flow

Si ya ha creado o importado la entidad de datos de destino, debería arrastrar la entidad de datos al lienzo de diseño y completar las asignaciones y opciones de columna.

Para crear la definición de una nueva tabla de destino mientras está en el editor de Data Flow:

  1. Seleccione el componente al final del flujo de datos.
  2. Haga clic en el icono Agregar entidad de datos Icono Agregar entidad de datos situado en la esquina superior derecha del componente de destino.
  3. Aparece la página Agregar entidad de datos, que permite configurar los siguientes detalles del componente de destino:

    Separador General

    • En el cuadro de texto Nombre, introduzca el nombre de la entidad de datos recién creada.
    • El cuadro de texto Alias se ha rellenado automáticamente con el nombre de la entidad de datos recién creada.
    • En la lista desplegable Tipo de conexión, seleccione la conexión necesaria desde la que desea agregar la entidad de datos recién creada.
    • Carga el nombre del servidor acuñado en el momento de la creación de la conexión. En la lista desplegable Servidor, seleccione el nombre de servidor necesario desde el que desea agregar la entidad de datos recién creada.
    • En la lista desplegable Plan, seleccione el esquema necesario.
    • Haga clic en Siguiente.

    Separador Columnas

    Permite crear, eliminar o editar las definiciones de columna.

    • Haga clic en el icono icono Agregar columnas Agregar columnas para agregar nuevas columnas a la entidad de datos recién creada.

      Se agrega una nueva columna a la tabla mostrada.

    • La tabla muestra las siguientes columnas:
      • Nombre
      • Tipo de datos: haga clic en la celda para configurar el tipo de datos necesario.
      • Escalar
      • Longitud
      • Acciones: haga clic en el icono de cruz para suprimir la columna creada.
    • Para suprimir las columnas en bloque, seleccione las columnas y haga clic en el icono Suprimir Suprimir.
    • Para buscar los detalles de columna necesarios, en el cuadro de texto Buscar, introduzca el nombre de columna necesario y haga clic en Introducir. Se muestran los detalles de la columna necesaria.
    • Haga clic en Siguiente.

    Separador Vista previa de entidad de datos

    Muestra una vista previa de todas las columnas creadas y sus detalles configurados. Si la entidad de datos pertenece a una base de datos Oracle, también puede ver las estadísticas de la tabla. Consulte Visualización de estadísticas de entidades de datos para obtener más información.

  4. Haga clic en Guardar.

    Se crea la nueva entidad de datos de destino.

  5. Amplíe el panel Propiedades del panel derecho para ver la siguiente configuración de los componentes creados:
    • General: muestra el nombre del componente junto con los detalles de conexión y esquema.
    • Atributos: muestra los detalles de todos los atributos asociados al componente.
    • Asignación de columnas: haga clic en Asignación automática para asignar todas las columnas automáticamente.
    • Vista previa: haga clic para obtener una previsualización del componente.
    • Opciones: cambie las opciones según corresponda.

Ver estadísticas de entidades de datos

El separador Vista previa muestra estadísticas detalladas de cada entidad de datos.

Nota

Esta función solo está disponible en tablas de bases de datos Oracle.
Puede ver las estadísticas de una entidad de datos seleccionada de una de estas formas:
  • En la lista Entidades de datos, haga clic en el icono Acciones (Icono Acciones) junto a la entidad de datos y haga clic en Vista previa. Seleccione el separador Estadísticas para ver las estadísticas de la entidad de datos seleccionada.
  • En cualquier flujo de datos, haga clic en cualquier entidad de datos de origen o destino y amplíe el panel de propiedades en el panel derecho. Haga clic en Presentación Preliminar.

Los datos estadísticos se presentan así:

  • El número total de filas y columnas de la entidad de datos se muestra en la parte superior.
  • En el panel de estadísticas se muestran los gráficos de vista en miniatura de cada columna con información sobre los valores mínimo, máximo, distinto y nulo.
  • Se muestran dos tipos de representaciones en miniatura según el histograma:
    • Un gráfico de barras representa los datos de histograma de frecuencia y frecuencia superior. En el gráfico de barras se muestran los primeros 10 valores principales para el número de filas de la tabla.
    • En una tabla se muestran los datos de los histogramas híbridos y equilibrados por altura. En la tabla se muestran todos los datos y se permite el desplazamiento. En la tabla se muestra el rango de valores y el porcentaje de filas de cada rango.
  • Puede hacer clic en cada vista en miniatura para ver las estadísticas de la columna en un nuevo separador del explorador.
  • En la vista detallada de cada gráfico también se muestra el tipo de histograma.