Datos de alimentación

Puede ejecutar una fuente de tabla activa bajo demanda, según un programa o como resultado de una notificación.

Una fuente de tabla activa automatiza la carga de datos en una tabla de la base de datos. Los archivos se cargan automáticamente a medida que aparecen en el almacenamiento de objetos y el sistema Live Table Feed garantiza que los archivos solo se carguen una vez. La carga se puede realizar manualmente, mediante un programa o incluso mediante notificaciones entregadas directamente desde Object Storage.

El cubo puede contener archivos con estos formatos: AVRO, CSV, JSON, GeoJSON, Parquet, ORC, TXT delimitado. Todos los archivos deben tener la misma firma de columna.

Gestionar conexiones de almacenamiento en la nube para fuentes de tablas activas

Antes de crear una fuente de tabla activa, debe establecer una conexión con el almacén en la nube que desea utilizar:

  1. Haga clic en Conexiones en el menú Carga de datos. Para obtener instrucciones, consulte Gestión de conexiones.

Crear un objeto de fuente de tabla activa

Para crear un objeto de fuente de tabla activa,
  1. En la página Fuente activa, haga clic en el botón + Crear fuente de tabla activa para mostrar el panel Configuración de fuente activa. Introduzca la información en el separador Data Source de la siguiente forma:
    • Ubicación de almacenamiento en la nube: seleccione la ubicación de almacenamiento en la nube en la lista desplegable. Seleccione la conexión en la nube para el cubo que contiene el archivo que desea utilizar para alimentar datos.

      En el modo Básico, puede ver las siguientes opciones:

    • Carpetas:

      Seleccione la carpeta que contiene los archivos que desea utilizar para alimentar datos en el almacén de objetos. Seleccione Cubo completo para cargar todos los archivos del cubo en la tabla. Las carpetas se muestran y organizan en la lista desplegable en función de cómo se crean las carpetas o directorios y se almacenan los archivos. Por ejemplo, puede crear una carpeta de ventas para almacenar archivos sales1.csv y sales2.csv.

    • Extensiones:

      Introduzca una extensión para limitar la fuente de la tabla activa solo a los archivos del cubo que coincidan con la extensión. Por ejemplo, para limitar los archivos solo a los archivos CSV, seleccione CSV.

      En el modo Avanzado, puede ver las siguientes opciones:

    • Filtro de objeto (glob): introduzca un valor glob de archivo para limitar la fuente de la tabla activa solo a los archivos del cubo que coincidan con el valor glob. Por ejemplo, para limitar los archivos solo a los archivos CSV, introduzca *.CSV.

    • En la sección Vista previa del archivo de fuente activa, puede ver una vista previa del archivo que seleccione en el paso anterior.

    Haga clic en Siguiente para avanzar al separador Configuración de tabla.

    En el campo Opción, seleccione cualquiera de las dos opciones disponibles:
    • Cargar tabla: esta opción agrega la fuente a la tabla de destino. Agrega nuevas filas a la tabla para cada archivo que visualiza.

    • Fusionar en tabla: esta opción fusiona los datos de fuente activa en la tabla de destino. Haga clic en Clave de fusión en la sección Asignación cuando la fila ya exista y la clave cargada coincida con la fuente recién agregada. Esto evita la inserción de una nueva fila.

    • Cargar recopilación: puede definir la fuente en directo a través de archivos JSON con esta opción. Al seleccionar esta opción, no podrá ver la sección de asignación ni la sección Agregar expresión. La herramienta carga los datos de origen en una recopilación de JSON que puede extraer más tarde.

    Nombre de tabla de destino: acepte el nombre por defecto o introduzca otro nombre. Nombre de la tabla de destino en la que se cargarán los datos de la fuente activa en la instancia de Autonomous Database. Si la tabla no existe, la fuente activa intentará adivinar las columnas correctas. Puede crear previamente la tabla en la que desea que se cargue la fuente activa. Esto es para mayor precisión.

    El separador Table Settings especifica opciones para controlar cómo se interpretan, previsualizan y procesan los datos de origen. Estas opciones varían en función del tipo de datos de origen.
    • Codificación: seleccione un tipo de codificación de caracteres de la lista. Esta opción está disponible cuando el archivo vinculado está en formato de texto sin formato (CSV, TSV o TXT). El valor de codificación por defecto es UTF-8.
    • Contenido de texto: seleccione el carácter para delimitar el texto: " (carácter de dos comillas),' (carácter de una comilla) o Ninguno. Esta opción sólo está visible cuando el archivo seleccionado está en formato de texto sin formato (CSV, TSV o TXT).
    • Delimitador de campo: seleccione el carácter delimitador utilizado para separar columnas en el origen. Por ejemplo, si el archivo de origen utiliza puntos y coma para delimitar las columnas, seleccione Semicolon en esta lista. El valor predeterminado es Comma. Esta opción sólo está visible cuando el archivo seleccionado está en formato de texto sin formato (CSV, TSV o TXT).
    • Iniciar procesamiento de datos en fila: especifica el número de filas que se deben omitir al enlazar los datos de origen a la tabla externa de destino:

      Si selecciona la opción Fila de cabecera de columna en Nombre de columna de origen (consulte a continuación) y si introduce un número mayor que 0 en el campo Iniciar procesamiento de datos en fila, ese número de filas después de la primera fila no estará enlazado al destino.

      Si anula la selección de la opción Fila de cabecera de columna en Nombre de columna de origen, y si introduce un número mayor que 0 en el campo Iniciar procesamiento de datos en fila, ese número de filas, incluida la primera fila, no estará enlazado al destino.

      Fila de cabecera de columna: seleccione la casilla de control Fila de cabecera de columna para utilizar los nombres de columna de la tabla de origen en la tabla de destino.

      Si selecciona esta opción, la primera fila del archivo se procesa como nombres de columna. Las filas de la sección Asignación, a continuación, se rellenan con esos nombres (y con los tipos de dato existentes, a menos que los cambie).

      Si anula la selección de esta opción, la primera fila se procesa como datos. Para especificar los nombres de columna manualmente, introduzca un nombre para cada columna de destino en la sección Asignación. (También tendrá que introducir tipos de dato).

      Seleccione la casilla de control Convertir datos no válidos en nulos para convertir un valor de columna numérico no válido en un valor nulo.

      Nuevas líneas incluidas en los valores de datos: seleccione esta opción si hay caracteres de línea nueva o si vuelve al principio de la línea actual sin avanzar hacia abajo en los campos de datos. Si selecciona esta opción, aumentará el tiempo que se tarda en procesar la carga. Si no selecciona esta opción al cargar los datos, se rechazarán las filas con líneas nuevas en los campos. Puede ver la fila rechazada en el panel Informe de trabajo.

    • Edite o actualice la configuración de la tabla en la sección Asignación: en este panel, se muestra la asignación de las columnas de origen a destino.

      El contenido de la tabla Asignación cambia según la opción de procesamiento que haya seleccionado en la sección Tabla y las propiedades que haya definido en la sección Propiedades.

      Puede filtrar los resultados en la tabla de asignación con el campo Filtro rápido que le permite filtrar Columnas o Expresiones.

      Seleccione Agregar expresión para realizar Análisis de sentimiento o extracción de frases clave o Detección de idioma o Traducción de textocon los datos de origen. Consulte Uso de las capacidades del servicio OCI Language en Data Studio para obtener más información.

      • Seleccione la casilla de verificación Incluir al principio de una fila para agregar la columna a la tabla de destino.
      • Seleccione o introduzca valores para los atributos de columna, como Nombre de columna de destino, Tipo de columna, Precisión, Escala, Valor por defecto, Clave primaria y Anulable.
      • Debe revisar el tipo de datos sugerido y, si es necesario, modificarlo introduciendo el tipo de datos directamente en la celda de destino.

        Revise el código de tabla de asignación generado en función de las selecciones realizadas en las pantallas anteriores.

        Haga clic en Clave de fusión en la sección Asignación cuando la fila ya exista y la clave cargada coincida con la fuente recién agregada. Esto evita la inserción de una nueva fila. Esta opción se muestra al seleccionar la opción Fusionar en tabla.

      Haga clic en Siguiente para avanzar al separador Vista previa.

    • El panel Preview muestra los cambios que realiza en la tabla.

    • Haga clic en Siguiente para avanzar al separador Configuración de fuente activa.

    En el separador Configuración de fuente activa, especifique los siguientes valores de campo:

    • Nombre de fuente de tabla activa: acepte el nombre por defecto o introduzca otro nombre para identificar esta fuente de tabla activa.

    • Activar para notificación: seleccione esta opción para que los datos nuevos o modificados del origen de datos se carguen según una notificación de Oracle Cloud Infrastructure. Al seleccionar esta opción, puede evitar retrasos que se pueden producir cuando el sondeo se inicia en un programa (es decir, si ha seleccionado la opción Programada de fuente de tabla activa).

      Al seleccionar la opción Activar para notificación, también debe:

      • Configurar el cubo del almacén de objetos para emitir notificaciones
      • Crear un tema de suscripción al servicio Notifications
      • Crear una Regla de Servicio de Eventos
      • Copiar URL de notificación
      • Crear una suscripción de servicio de notificaciones
      • Confirmar que se permiten notificaciones

      Para obtener instrucciones completas, consulte Creación de una fuente de tabla activa basada en notificaciones.

    • Activar para programación: seleccione esta opción para configurar un programa para ejecutar el objeto de fuente de tabla activa, es decir, para sondear el origen de datos de forma regular:
      • En los campos de intervalo de tiempo, introduzca un número y seleccione un tipo de tiempo y los días en los que sondear el cubo para buscar archivos nuevos o modificados. Por ejemplo, para sondear cada dos horas los lunes, miércoles y viernes, introduzca 2 y seleccione Horas. Puede seleccionar Todos los días, De lunes a viernes, De domingo a jueves o Personalizado en la lista desplegable Días de semana. El campo Personalizado permite seleccionar Lunes, Martes, Miércoles, Jueves y Viernes en los campos adecuados.

      • Seleccione una fecha de inicio y una fecha de finalización con las horas de inicio y finalización. Si no selecciona una fecha de inicio, la fecha y la hora actuales se usan como fecha de inicio. La fecha de finalización es opcional. Sin embargo, sin una fecha de finalización, el feed en vivo continuará sondeando.

    Seleccione un grupo de consumidores de la lista desplegable, es decir, bajo, medio y alto.

  2. Haga clic en Crear para crear el objeto de fuente de tabla activa.

    Mostrar código: seleccione esta opción para ver el equivalente de código PL/SQL del asistente Crear fuente de tabla activa. Puede copiar y ejecutar este código PL/SQL en la hoja de trabajo para realizar la misma acción que se produce al hacer clic en Crear en el asistente Crear fuente de tabla activa.

Mostrar, filtrar y ordenar objetos de fuente de tabla activa

Al abrir la página Fuente activa, los objetos de fuente de tabla activa existentes se muestran como tarjetas en la página. Se identifican como entidades LIVE_TABLE_FEED.

Para filtrar objetos de fuente de tabla activa:

  1. Haga clic en el campo de búsqueda situado en la parte superior de la página para mostrar las opciones de filtro. Por defecto, se muestran los objetos de fuente de tabla activa del esquema del usuario actual. Tan pronto como empiece a escribir en el campo de búsqueda, la herramienta de alimentación devuelve los valores que contienen las letras que escribe. Puede eliminar el filtro eliminando el contenido del cuadro de búsqueda y haciendo clic en el icono de cruz que aparece junto al cuadro de búsqueda.

  2. Para incluir objetos de otros esquemas, seleccione la lista desplegable situada junto al campo de búsqueda, en Esquema. Para eliminar un esquema de la lista de filtros, anule la selección de la casilla situada junto a su nombre.

  3. Para mostrar objetos de todos los esquemas disponibles, seleccione Todo en la lista desplegable Esquema.

Para ordenar objetos de fuente de tabla activa

  1. Haga clic en el botón Ordenar por en la parte superior derecha de la página.

  2. Seleccione una opción de ordenación. Para ordenar ascendente, haga clic en el icono con la flecha hacia arriba. Para ordenar en sentido descendente, haga clic en el icono con la flecha hacia abajo.

Buscar y ver objetos de fuente de tabla activa

Para buscar las entidades de fuente de tabla activa disponibles en los esquemas seleccionados, introduzca un valor en el campo de búsqueda de la parte superior de la página y pulse Intro. A continuación, la visualización incluye solo las entidades cuyos nombres contienen los caracteres en el campo de búsqueda. Para borrar el campo de búsqueda, haga clic en el icono Borrar resultados de búsqueda (X) en el campo de búsqueda.

Para eliminar un esquema o un valor de ordenación de los filtros seleccionados, anule la selección del esquema o el valor de ordenación en el panel de filtros o haga clic en el icono Eliminar filtro (X) del esquema o el valor de ordenación por encima de la visualización de los objetos de fuentes de tablas activas. Para cerrar el panel de filtros, haga clic en el icono Ocultar panel de filtros (X) del panel.

Para refrescar la visualización de las fuentes de tablas activas, haga clic en el icono Refrescar en la parte superior de la página.

Editar un objeto de fuente de tabla activa

Para editar los detalles de un objeto de fuente de tabla activa,
  1. En la página Fuente activa, busque la tarjeta de la fuente de la tabla activa cuyos detalles desea editar.
  2. Haga clic en el icono Acciones (tres puntos) de la tarjeta y seleccione Editar fuente de tabla activa. Puede editar las siguientes opciones:
    • Introduzca la información en el separador Data Source de la siguiente forma:
    • Ubicación de almacenamiento en la nube: seleccione la ubicación de almacenamiento en la nube en la lista desplegable. Seleccione la conexión en la nube para el cubo que contiene el archivo que desea utilizar para alimentar datos.
      • En el modo Básico, puede ver las siguientes opciones:

      • Carpetas:

        Seleccione la carpeta que contiene el archivo que desea utilizar para alimentar datos en el almacén de objetos. Seleccione Cubo completo para cargar todos los archivos en el cubo. Las carpetas se muestran y organizan en la lista desplegable en función de cómo se crean las carpetas o directorios y se almacenan los archivos. Por ejemplo, puede crear una carpeta de ventas para almacenar archivos sales1.csv y sales2.csv.

      • Extensiones:

        Introduzca una extensión para limitar la fuente de la tabla activa solo a los archivos del cubo que coincidan con la extensión. Por ejemplo, para limitar los archivos solo a los archivos CSV, seleccione CSV.

        En el modo Avanzado, puede ver las siguientes opciones:

      • Filtro de objeto (glob): introduzca un valor glob de archivo para limitar la fuente de la tabla activa solo a los archivos del cubo que coincidan con el valor glob. Por ejemplo, para limitar los archivos solo a los archivos CSV, introduzca *.CSV.

    • En el separador Configuración de fuente activa, edite los siguientes campos:

    • Activar para notificación: seleccione esta opción para que los datos nuevos o modificados del origen de datos se carguen según una notificación de Oracle Cloud Infrastructure. Al seleccionar esta opción, puede evitar retrasos que se puedan producir al iniciar el sondeo según un programa (es decir, la opción Programada de fuente de tabla activa).

      Al seleccionar la opción Activar para notificación, también debe:

      • Copiar URL de notificación de fuentes de tabla activa
      • Configure su almacén en la nube para emitir notificaciones
      • Configure Oracle Cloud Infrastructure para enrutar eventos al punto final utilizado para la fuente de tabla activa.
      • Cree una regla.
      • Cree una suscripción.
      • Confirme que las notificaciones están permitidas en el servicio de fuente activa.

      Para obtener instrucciones completas, consulte Creación de una fuente de tabla activa basada en notificaciones.

    • Programado: seleccione esta opción para configurar un programa para ejecutar el objeto de fuente de tabla activa; es decir, para sondear el origen de datos en una base normal:
      • En los campos de intervalo de tiempo, introduzca un número y seleccione un tipo de tiempo y los días en los que sondear el cubo para buscar archivos nuevos o modificados. Por ejemplo, para sondear cada dos horas los lunes, miércoles y viernes, introduzca 2 y seleccione Horas. Puede seleccionar Todos los días, De lunes a viernes, De domingo a jueves o Personalizado en la lista desplegable Días de semana. El campo Personalizado permite seleccionar Lunes, Martes, Miércoles, Jueves y Viernes en los campos adecuados.

      • Seleccione una fecha de inicio y una fecha de finalización con las horas de inicio y finalización.

  3. Haga clic en Guardar.

Ejecutar fuente de tabla activa

Puede ejecutar una fuente de tabla activa bajo demanda, según un programa o como resultado de una notificación.

Para ejecutar una fuente de tabla activa a petición:

  1. En la página Live Feed, busque la tarjeta para la fuente de tabla activa que desea ejecutar.
  2. Haga clic en el icono Acciones (tres puntos) de la tarjeta y seleccione Ejecutar fuente de tabla activa inmediatamente (una vez).

Para ejecutar una fuente de tabla activa a petición:

Puede definir un programa para ejecutar fuentes de tablas activas en el panel Crear fuente de tabla activa (al crear una nueva fuente de tabla) o en el panel Editar fuente de tabla activa (al editar una fuente de tabla existente). Consulte Creación de un objeto de fuente de tabla activa o Edición de un objeto de fuente de tabla activa.

Para ejecutar una fuente de tabla activa como resultado de una notificación:

Consulte Creación de una fuente de tabla activa basada en notificaciones.

Seleccione la casilla de control Programado para mostrar las opciones de programa y, a continuación, defina el programa seleccionando las opciones que desee.

Para ver los detalles de ejecución de fuente de tabla activa:

  1. En la página Fuente activa, busque la tarjeta de la fuente de la tabla activa cuyos detalles de ejecución desea ver.
  2. Haga clic en el icono Acciones (tres puntos) de la tarjeta y seleccione Detalles de ejecución de fuente de tabla activa.

    El separador Objetos del panel Detalles de ejecución de fuente de tabla activa muestra información sobre los trabajos, como cuándo se ha producido la ejecución, los objetos implicados en la ejecución, el propietario de la tabla, el nombre de la tabla, el estado de la fuente activa, las filas cargadas y las filas rechazadas, y otros detalles. Haga clic en el separador Todo para ver más detalles, como el tipo de evento.

Suprimir una fuente de tabla activa

  1. En la página Fuente activa, busque la tarjeta para el trabajo de fuente de tabla activa que desea suprimir.
  2. Haga clic en el icono Acciones (tres puntos) de la tarjeta y seleccione Suprimir fuente de tabla activa.

Creación de una fuente de tabla activa basada en notificaciones

Puede cargar datos mediante una fuente de tabla activa basada en una notificación de Oracle Cloud Infrastructure.

Además de poder ejecutar una fuente de tabla activa bajo demanda o según un programa, como se describe en Federación de datos, también puede ejecutar una fuente como resultado de una notificación. Cuando se cambian los datos del cubo de origen, se envía una notificación que dispara una ejecución de la fuente de la tabla. Con una fuente de tabla activa basada en notificaciones, puede evitar cualquier retraso que pueda derivarse de la ejecución de trabajos de fuente de tabla activa bajo demanda o programados.

Nota

  • Las fuentes de tablas activas basadas en notificaciones no están disponibles en el nivel gratuito de Oracle Cloud Infrastructure. Para utilizar esta función, debe estar en un arrendamiento de pago con los permisos adecuados en su cuenta.

  • Las fuentes de tablas activas basadas en notificaciones no están disponibles en las bases de datos de Oracle Autonomous Data Warehouse (ADW) que se configuran mediante un punto final privado.

Para crear una fuente de tabla activa basada en notificaciones:

Consejo:

Para realizar estos pasos, alternará entre las páginas de la consola de Oracle Cloud Infrastructure y las páginas de Oracle Database Actions. Puede que le resulte conveniente abrir la consola en la nube en una página o separador del explorador y Database Actions en otro, por lo que es fácil avanzar y retroceder.

Paso 1: Configurar el cubo del almacén de objetos para emitir notificaciones

Dónde: página Consola de Oracle Cloud Infrastructure: Object Storage y Archive Storage - Cubos

Configure el cubo que contiene los datos de origen para que emita notificaciones cuando cambien los datos. Puede definir esta opción al crear un cubo o puede definirlo en un cubo existente.

  1. Abra el menú de navegación de la consola de Cloud y haga clic en Almacenamiento. En Almacenamiento de objetos de archivo, haga clic en Cubos.
  2. Si va a crear un nuevo cubo:

    1. En la página Cubos, haga clic en el botón Crear cubo para crear un nuevo cubo, como se describe en Gestión de cubos. En el asistente Crear cubo, seleccione la opción Emit Object Events, junto con las otras opciones del nuevo cubo.
    2. Haga clic en Crear.

    Si está utilizando un cubo existente:

    1. En la página Cubos, haga clic en el nombre del cubo que desea utilizar, como se describe en Gestión de cubos.
    2. En la página Detalles de cubo, haga clic en el enlace Editar situado junto a Emitir eventos de objeto.
    3. Seleccione la casilla de control Emitir eventos de objetos y, a continuación, haga clic en Guardar cambios.

Paso 2: Crear un tema de suscripción al servicio Notifications

Dónde: consola de Oracle Cloud Infrastructure: notificaciones - página Temas

  1. Abra el menú de navegación de la consola en la nube y haga clic en Developer Services. En Integración de aplicación, haga clic en Notificaciones.
  2. Haga clic en Crear tema, introduzca un nombre y una descripción opcional y, a continuación, haga clic en Crear.

Paso 3: Crear una regla de servicio Events

Dónde: página Consola de Oracle Cloud Infrastructure: eventos - reglas

  1. Abra el menú de navegación de la consola en la nube y haga clic en Observación y gestión. En Servicio de eventos, haga clic en Reglas.
  2. Haga clic en Crear regla y rellene la página Crear regla como se describe en Gestión de reglas para eventos.
    • En Condiciones de regla, seleccione:
      • Condición: Tipo de evento
      • Nombre del servicio: Object Storage
      • Tipo de evento: objeto - Crear
    • En Acciones, seleccione:
  3. Haga clic en Crear regla.

Paso 4: Crear y configurar una fuente de tabla activa para utilizar notificaciones y copiar la URL de notificación

Dónde: página Database Actions: fuentes activas

Puede configurar una fuente de tabla activa nueva o existente para utilizar notificaciones:

  1. Vaya a la página Fuentes activas de Database Actions, como se describe en Federación de datos.
  2. Cree o edite un objeto de fuente de tabla activa, como se describe en Crear un objeto de fuente de tabla activa o Editar un objeto de fuente de tabla activa. Seleccione la opción Activar para notificación
  3. Haga clic en Crear o en Guardar.
  4. Haga clic en el icono Acciones (tres puntos verticales) de la tarjeta de la fuente activa y seleccione Mostrar URL de confirmación.
  5. En el cuadro de diálogo URL de notificación, haga clic en el icono Copiar para copiar la URL en el portapapeles. Puede que desee copiarlo en un archivo temporal, para que pueda recuperarlo más tarde. Esta URL se utilizará en el siguiente paso, Paso 5: Crear una suscripción al servicio Notifications.

Paso 5: Crear una suscripción al servicio Notifications

Dónde: página Consola de Oracle Cloud Infrastructure: notificaciones - suscripciones

  1. Vuelva a la consola de Oracle Cloud Infrastructure. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Integración de aplicación, haga clic en Notificaciones.
  2. En la página Notificaciones, haga clic en el separador Suscripciones (en la parte izquierda de la página), el estado será Activo.
  3. Haga clic en Crear suscripción y rellene la página Crear suscripción:

Paso 6: Confirme que el punto final puede recibir notificaciones

Dónde: página Database Actions: fuentes activas

  1. Vuelva a la página Database Actions Live Feeds y busque la tarjeta para la fuente de tabla activa que está configurando para una fuente basada en notificaciones.
  2. Verá la tarjeta de transmisión activa en estado Activo.

Recibirá notificaciones por correo electrónico cuando se produzcan determinados eventos específicos de transmisión en vivo.

Consulte Envío de correo electrónico mediante la herramienta de fuente activa para obtener más información.

Una vez que haya terminado los pasos anteriores, los nuevos archivos cargados en el cubo se cargarán automáticamente en la tabla de fuentes de tabla activa.

Creación de una fuente de tabla activa basada en notificaciones mediante el servicio de almacenamiento simple de Amazon (S3)

Puede integrar Amazon Simple Storage Service (S3) y Oracle Cloud Infrastructure (OCI) para automatizar el proceso de notificaciones de fuentes activas cuando los objetos de almacenamiento que observa tienen actualizaciones. En la siguiente sección se proporcionan instrucciones para crear notificaciones de eventos en el cubo de Amazon S3 en el que se almacenan los archivos de datos.

Consejo:

Para completar estos pasos, deberá alternar entre la consola de gestión de Amazon Web Services (AWS) y las páginas de Oracle Database Actions. Puede que le resulte conveniente abrir Amazon Web Services en una página o pestaña del navegador y Database Actions en otra, por lo que es fácil moverse hacia adelante y hacia atrás.

Paso 1: Crea tu cubo de almacenamiento de objetos en Amazon S3

Dónde: consola de gestión de Amazon Web Services (AWS)

Configure y cree un cubo que contenga datos de origen para que emita notificaciones cuando cambien los datos.
  1. Inicie sesión en la consola de administración de AWS y abra la consola de Amazon S3.
  2. En la página inicial, haga clic en el icono Crear cubo.
  3. En Nombre de cubo, introduzca un nombre válido para el cubo. Por ejemplo: testbucket. Después de crear el cubo, no puede cambiar su nombre.
  4. En Región, seleccione la región de Amazon Web Services (AWS) en la lista desplegable. Por ejemplo: us-west-2
  5. En Configuración de cubo para el acceso público de bloque, seleccione la configuración de Bloquear acceso público que desea aplicar al cubo. Se recomienda mantener todas las configuraciones activadas a menos que sepa que necesita desactivar cualquiera de ellas.
  6. Seleccione Configuración avanzada y acepte todas las opciones por defecto si desea activar el bloqueo de objeto S3. Este paso es opcional.
  7. Seleccione Crear cubo.

Paso 2: Crear claves de acceso

Dónde: consola de administración de AWS

Para acceder a Amazon Simple Notification Service (SNS), debe tener credenciales que Amazon Web Services (AWS) pueda utilizar para validar sus solicitudes. Estas credenciales deben tener permisos para acceder a los temas de Amazon SNS. Los siguientes pasos proporcionan detalles sobre los pasos para crear claves de acceso mediante AWS Identity and Access Management (IAM) por motivos de seguridad.

  1. Inicie sesión en la consola de AWS Management y abra la consola de Amazon Identity and Access Management (IAM).
  2. En el menú de navegación, seleccione Usuarios.
  3. Seleccione su nombre de usuario.
  4. En el separador Credenciales de seguridad, seleccione Crear clave de acceso.
  5. Copie el ID de clave de acceso y la clave de acceso secreto en la pantalla. Pegarlos en un portapapeles.
  6. Para descargar las claves, seleccione el icono archivo Download.csv. De esta forma, puede almacenar el archivo en una ubicación segura.

Paso 3: Agregar un enlace de almacenamiento en la nube de Amazon S3

Dónde: página Acciones de base de datos: Gestionar nube

Antes de crear una fuente de tabla activa, debe establecer una conexión con el almacén en la nube que desea utilizar.

  1. Haga clic en el botón Gestionar almacén en la nube situado en la parte superior de la página para ir a la página Gestionar nube. Para obtener más instrucciones sobre cómo agregar archivos de origen que residen en el almacenamiento en la nube proporcionado por Amazon S3, consulte el tema Creación de un enlace de almacenamiento en la nube de Amazon S3 en Gestión de conexiones.
    Nota

    Pegue el ID de clave de acceso y la clave de acceso secreta generados en el paso anterior (Paso 2: Crear claves de acceso) en sus respectivos campos de texto en la página Agregar almacenamiento en la nube.

Paso 4: Crear y configurar una fuente de tabla activa para utilizar notificaciones y copiar la URL de notificación

Dónde: página Database Actions: fuentes activas

La creación de una fuente de tabla activa permite cargar datos en tiempo real desde orígenes de almacenamiento externo a la tabla en ADB. El almacenamiento externo que se utiliza incluye como contenedores de Oracle Object Store, AWS S3 o Microsoft Azure.

Puede configurar una fuente de tabla activa nueva o existente para utilizar notificaciones:

  1. Vaya a la página Fuentes activas de Database Actions, como se describe en Federación de datos.
  2. Cree o edite un objeto de fuente de tabla activa, como se describe en Crear un objeto de fuente de tabla activa o Editar un objeto de fuente de tabla activa. Seleccione la opción Activar para notificación
  3. Haga clic en Crear o en Guardar.
  4. Haga clic en el icono Acciones (tres puntos verticales) de la tarjeta de la fuente activa y seleccione Mostrar URL de notificación.
  5. En el cuadro de diálogo URL de notificación, haga clic en el icono Copiar para copiar la URL en el portapapeles. Puede que desee copiarlo en un archivo temporal, para que pueda recuperarlo más tarde. Utilizará esta URL en el paso siguiente (Paso 7: Creación de una suscripción al servicio de notificaciones).

Paso 5: Crear un tema de suscripción al servicio de notificaciones

Dónde: consola de Amazon Simple Notification Service (SNS)

Recibirá notificaciones de Amazon S3 mediante el tema Amazon Simple Notification Service (Amazon SNS). Debe agregar una configuración de notificación al cubo mediante un tema de Amazon SNS. Los temas de SNS son ubicaciones compartidas que se utilizan para enviar notificaciones de varios eventos que se producen en los cubos de AWS.

Durante la creación, seleccione un nombre de tema y un tipo de tema. Después de crear un tema, no puede cambiar el tipo ni el nombre del tema. Todas las demás opciones de configuración son opcionales durante la creación del tema, que puede editar más adelante.

Para acceder a cualquier servicio de AWS, primero debe crear una cuenta de AWS.

Vaya a la consola de administración de AWS y, a continuación, seleccione Crear una cuenta de AWS.

Siga las instrucciones que se proporcionan en el enlace de Amazon SNS para crear el primer usuario y grupo de administradores de IAM. Ahora puede iniciar sesión en cualquiera de los servicios de AWS como usuario de IAM.

  1. Inicie sesión en la consola de Amazon SNS como usuario de IAM.
  2. En la página Temas, seleccione Crear tema.
  3. Especifique los siguientes campos en la página Crear tema, en la sección Detalles.
    • Tipo:estándar (estándar o FIFO)
    • Nombre: tema de notificación. Para un tema FIFO, agregue FIFO al final del nombre.
    • Nombre mostrado: este campo es opcional.
  4. Amplíe la sección Cifrado y seleccione Desactivar cifrado.
  5. Amplíe la sección Política de acceso y configure permisos de acceso adicionales, si es necesario. Por defecto, solo el propietario del tema puede publicar o suscribirse al tema. Este paso es opcional. Edite el formato JSON de la política según los detalles del tema que introduzca. A continuación, se muestra un ejemplo de política de acceso en formato JSON.
    { "Version": "2008-10-17",
    "Id": "__default_policy_ID",
    "Statement":[
    {"Sid": "__default_statement_ID",
    "Effect": "Allow",
    "Principal": {"AWS": "*"
    },"Action": [
            "SNS:Publish",
            "SNS:RemovePermission",
            "SNS:SetTopicAttributes",
            "SNS:DeleteTopic",
            "SNS:ListSubscriptionsByTopic",
            "SNS:GetTopicAttributes",
            "SNS:AddPermission",
            "SNS:Subscribe"
          ],
          "Resource": "arn:aws:sns:us-west-2:555555555555:notify-topic", //us-west-2 is the region
          "Condition": {
            "StringEquals": {
              "AWS:SourceOwner": "555555555555"
            }
          }
        },
        {
          "Sid": "s3_policy", //This field accepts string values
          "Effect": "Allow",
          "Principal": {
            "Service": "s3.amazonaws.com"
          },
          "Action": [
            "SNS:Publish"
          ],
          "Resource": "arn:aws:sns:us-west-2:555555555555:notify-topic", //notify-topic is the topic name
          "Condition": {
            "StringEquals": {
              "aws:SourceAccount": "555555555555" //This is the Account ID
            },
            "ArnLike": {
              "aws:SourceArn": "arn:aws:s3:*:*:testbucket /*testbucket is the s3 bucket name. You will get notifications only when file is uploaded to this
        bucket.*/
    "
            }
          }
        }
      ]
    }
    
  6. Expanda la sección Política de reintento de entrega (HTTP/S) para configurar cómo reintenta Amazon SNS los intentos fallidos de entrega de mensajes. Este paso es opcional.
  7. Expanda la sección Registro de estado de entrega para configurar cómo Amazon SNS registra la entrega de mensajes en CloudWatch. Este paso es opcional.
  8. Amplíe la sección Etiquetas para agregar etiquetas de metadatos al tema. Este paso es opcional.
  9. Seleccione Crear tema.
  10. El nombre del tema, la ARN (nombre del recurso de Amazon) y el ID de cuenta de AWS del propietario del tema se muestran en la sección Detalles.
  11. Copie el tema ARN en el portapapeles.

Paso 6: Activar y configurar las notificaciones de eventos con la consola de Amazon S3

Dónde: consola de gestión de Amazon S3

Puede activar los eventos de bloque de Amazon S3 para que envíen un mensaje de notificación a un destino siempre que se produzcan dichos eventos. Configure notificaciones de eventos para el cubo S3 para notificar a OCI cuando haya una actualización o nuevos datos disponibles para cargar. En los siguientes pasos se explica el procedimiento que se debe seguir en la consola de Amazon S3 para activar las notificaciones de eventos.

  1. Inicie sesión en la consola de gestión de Amazon S3 e inicie sesión como usuario de IAM (Amazon Identity and Access Management).
  2. En la lista Cubos, seleccione el nombre del cubo, es decir, testbucket. Este es el cubo que ha creado en el Paso 1: Crear el cubo del almacén de objetos en Amazon S3.
  3. Seleccione el icono Propiedades.
  4. Vaya a la sección Notificaciones de evento y seleccione el icono Crear notificación de evento.
  5. En la sección Configuración general, especifique los siguientes valores para la notificación de eventos.
    • Nombre de evento: notificación de cubo
    • Prefijo: este valor sirve para filtrar notificaciones de eventos por prefijo. Es un valor opcional. Esto se agrega para filtrar la actividad de eventos.
    • Sufijo: este valor sirve para filtrar notificaciones de eventos por sufijo. Es un valor opcional. Esto se agrega para filtrar la actividad de eventos.
  6. En la sección Tipos de eventos, seleccione uno o más tipos de eventos para los que desee recibir notificaciones. Si no está seguro de qué tipos de eventos seleccionar, seleccione la opción Todos los eventos de creación de objetos.
  7. En la sección Destino, seleccione Tema de SNS como destino de notificación de eventos.
    Nota

    Para poder publicar notificaciones de eventos, debe otorgar a Amazon S3 los permisos necesarios para llamar a la API correspondiente. Esto permite publicar notificaciones en una función Lambda o en un tema SNS.
  8. Después de seleccionar el tema SNS como destino de notificación de eventos, seleccione el tema SNS, es decir, el tema de notificación en la lista desplegable. Este es el tema que ha creado en el Paso 5: Crear un tema de suscripción de servicio de notificaciones.
  9. Seleccione Guardar cambios.

Paso 7: Crear una suscripción de servicio de notificaciones

Dónde: consola de Amazon SNS

Cada tema de Amazon SNS tiene un conjunto de suscripciones. Una vez que un mensaje se publica en un tema, SNS maneja la distribución del mensaje a todos sus suscriptores. Los suscriptores pueden ser funciones de AWS Lambda, puntos finales HTTP(S), direcciones de correo electrónico y números de teléfono móvil capaces de recibir mensajes SMS.

Amazon SNS hace coincidir el tema con una lista de suscriptores que se han suscrito a ese tema y entrega el mensaje a cada uno de esos suscriptores.

  1. Inicie sesión en la consola de Amazon SNS.
  2. En el panel de navegación de la izquierda, seleccione Suscripciones.
  3. Seleccione Crear suscripción en la página de suscripciones.
  4. En la sección Detalles de la página Crear suscripción, especifique los siguientes valores.
  5. Expanda la sección Política de filtro de suscripción para configurar una política de filtro. Este paso es opcional.
  6. Expanda la sección Redrive policy (dead-letter queue) para configurar una cola de mensajes con problemas de entrega para la suscripción. Este paso es opcional.
  7. Seleccione Crear suscripción.
Nota

Los puntos finales HTTP(S), las direcciones de correo electrónico y los recursos de AWS en otras cuentas de AWS requieren la confirmación de la suscripción antes de que puedan recibir mensajes.

Paso 8: Confirme que el punto final puede recibir notificaciones

Dónde: página Database Actions: fuentes activas

  1. Vuelva a la página Database Actions Live Feeds y busque la tarjeta para la fuente de tabla activa que está configurando para una fuente basada en notificaciones.
  2. Haga clic en el icono Acciones (tres puntos verticales) de la tarjeta y seleccione Mostrar URL de confirmación.
  3. En el cuadro de diálogo URL de confirmación, haga clic en el enlace para confirmar la URL. Esto no cierra este recuadro de diálogo. Si el enlace se realiza correctamente, se muestra un mensaje que confirma que la suscripción está activa.
  4. Vuelva al cuadro de diálogo URL de confirmación y seleccione la casilla de control Comprobar solo cuando haya finalizado el proceso de confirmación del almacén en la nube y haga clic en Aceptar.

Una vez que haya terminado los pasos anteriores, los nuevos archivos cargados en el cubo se cargarán automáticamente en la tabla de fuentes de tabla activa.

Para obtener más información sobre cómo activar y configurar notificaciones de eventos mediante la consola de Amazon S3, consulte Activación y configuración de notificaciones de eventos mediante la consola de Amazon S3.

Creación de una fuente de tabla activa basada en notificaciones mediante Microsoft Azure

Una fuente de tabla activa basada en notificaciones es una interfaz entre Oracle Cloud Infrastructure y un servicio de cola de mensajes en la nube de terceros, como Azure Event Grid.

En la siguiente sección se explica el procedimiento para generar mensajes de fuente activa automática mediante Microsoft (MS) Azure como almacenamiento en la nube. Cuando hay una actualización en el contenedor y se cumplen las condiciones de notificación, se genera un mensaje de log y se muestra en la fuente activa de Oracle Cloud Infrastructure.

Para crear una fuente activa basada en notificaciones con Microsoft Azure como almacenamiento en la nube, debe:

Consejo:

Para completar los pasos anteriores, deberá alternar entre el portal de Microsoft Azure y las páginas de Oracle Database Actions. Puede que le resulte conveniente abrir el portal de Microsoft Azure en una página o separador del explorador y Database Actions en otro, por lo que es fácil moverse hacia adelante y hacia atrás.

Paso 1: Crear un grupo de recursos en Microsoft Azure

Dónde: Microsoft Azure Portal

Los grupos de recursos son contenedores lógicos en los que puede gestionar recursos de Azure, como cuentas de almacenamiento. Los grupos de recursos se crean para que pueda desplegarlos, actualizarlos y suprimirlos como grupo. Puede crear un grupo de recursos siguiendo estos pasos:
  1. En el portal de Azure, haga clic en el botón Grupos de recursos.
  2. Seleccione Agregar.
  3. Introduzca los siguientes valores:
    • Suscripción: seleccione su suscripción a Azure, como Microsoft Azure Enterprise.
    • Grupo de recursos: introduzca un nombre de grupo nuevo de recursos, como el de grupo.
    • Región: seleccione su ubicación, como Oeste de EE. UU.
  4. Haga clic en Revisar+crear.
  5. Haga clic en Crear. La creación de un grupo de recursos tarda unos segundos.

Paso 2: Crear una cuenta de almacenamiento en Microsoft Azure

Dónde: Microsoft Azure Portal

Una cuenta de almacenamiento de Azure contiene todos los objetos de datos de almacenamiento, como blobs, tablas, discos, etc. Puede crear una cuenta de almacenamiento dentro del grupo de recursos. Proporciona un espacio de nombres único para los datos. Para crear una cuenta de almacenamiento, haga lo siguiente:

  1. En el menú del portal de la izquierda, seleccione Cuentas de almacenamiento para mostrar una lista de las cuentas de almacenamiento.
  2. En la página Cuentas de almacenamiento, haga clic en el icono Crear.
  3. En la ficha Básico, proporcione la siguiente información para su cuenta de almacenamiento.
    • Suscripción: Microsoft Azure Enterprise
    • Grupo de recursos: grupo de recursos
    • Nombre de cuenta de almacenamiento: teststorage
    • Región: seleccione su ubicación, como Oeste de EE. UU.
    • Redundancia: almacenamiento redundante local (LRS)
  4. Puede seleccionar Revisar+crear para aceptar las opciones por defecto y continuar con la validación de la cuenta.
  5. Una vez superada la validación, puede hacer clic en la cuenta Crear almacenamiento. En caso de que la validación falle, el portal indica qué configuración se debe modificar.

Paso 3: Crear claves de acceso

Dónde: Microsoft Azure Portal

Debe otorgar a Microsoft Azure los permisos necesarios para obtener claves de acceso en las ubicaciones de almacenamiento. Las claves de acceso específicas de la cuenta de almacenamiento se generan automáticamente después de crear la cuenta de almacenamiento en el paso anterior. Los siguientes pasos describen el procedimiento para crear claves de acceso.

  1. En Security+Networking, seleccione Claves de acceso. Las claves de acceso a la cuenta aparecen con la cadena de conexión completa para cada clave.
  2. Seleccione Mostrar claves para mostrar las claves de acceso y la cadena de conexión para cada clave y para copiar valores.
  3. Copie el valor de la cadena de conexión en key1. Este valor se pegará en el campo de texto Clave de acceso de cuenta de almacenamiento de Azure del siguiente paso (Paso 5: Agregar almacenamiento en la nube mediante el almacén en la nube de Microsoft Azure).
  4. Copie el nombre de la cuenta de almacenamiento, es decir, teststorage, y péguelo en el campo de texto Nombre de cuenta de almacenamiento de Azure del siguiente paso (Paso 5: Agregar almacenamiento en la nube mediante el almacén en la nube de Microsoft Azure).
  5. Pruebe las credenciales para ver si funcionan o no.

Paso 4: Crear un contenedor

Dónde: Microsoft Azure Portal

Un contenedor es una ubicación (también conocida como bloques en Amazon S3 y OCI) que contiene almacenamiento de Azure Blob (objetos grandes binarios). Para crear un contenedor, siga estos pasos.

  1. Navegue a su nueva cuenta de almacenamiento en el portal de Azure.
  2. En el menú de la izquierda de la cuenta de almacenamiento, desplácese a la sección Almacenamiento de datos y, a continuación, seleccione Contenedores.
  3. Haga clic en el icono +Container.
  4. Introduzca el nombre del nuevo contenedor. El nombre del contenedor debe estar en minúscula, debe empezar por una letra o un número y solo puede incluir letras, números y el carácter de guion.
  5. Defina el nivel de Nivel de acceso público en Privado. El nivel predeterminado es Privado.
  6. Seleccione Crear para crear el contenedor.

Paso 5: Agregar almacenamiento en la nube utilizando la tienda en la nube de Microsoft Azure

Dónde: página Acciones de base de datos: Gestionar nube

  1. Haga clic en el botón Gestionar almacén en la nube situado en la parte superior de la página para ir a la página Gestionar nube. Para obtener más instrucciones sobre cómo agregar archivos de origen que residen en el almacenamiento en la nube proporcionado por el almacenamiento en la nube de Microsoft Azure, consulte el tema Creación de un enlace de almacenamiento en la nube de Microsoft Azure en la sección Gestión de conexiones.
Nota

Pegue el valor de la cadena de conexión en la clave 1 del paso anterior Paso 3: Crear claves de acceso en el campo de texto Clave de acceso de cuenta de almacenamiento de Azure de la página Agregar almacenamiento en la nube. Pega también el nombre de la cuenta de almacenamiento generado en el paso anterior Paso 3: Crear claves de acceso en el campo de texto Nombre de cuenta de almacenamiento de Azure de la página Agregar almacenamiento en la nube.

Paso 6: Crear y configurar una fuente de tabla activa para utilizar notificaciones y copiar la URL de notificación

Dónde: página Database Actions: fuentes activas

El objeto de fuente de tabla activa permite que los datos se carguen desde el almacenamiento en la nube de Microsoft Azure sin demora de sondeo. Este objeto crea una integración entre la interfaz de Oracle Cloud y Microsoft Azure.

Puede configurar una fuente de tabla activa nueva o existente para utilizar notificaciones:

  1. Vaya a la página Fuentes activas de Database Actions, como se describe en Federación de datos.
  2. Cree o edite un objeto de fuente de tabla activa, como se describe en Crear un objeto de fuente de tabla activa o Editar un objeto de fuente de tabla activa. Seleccione la opción Activar para notificación
  3. Haga clic en Crear o en Guardar.
  4. Haga clic en el icono Acciones (tres puntos verticales) de la tarjeta de la fuente activa y seleccione Mostrar URL de confirmación.
  5. En el cuadro de diálogo URL de notificación, haga clic en el icono Copiar para copiar la URL en el portapapeles. Puede que desee copiarlo en un archivo temporal, para que pueda recuperarlo más tarde. Esta URL se utilizará en el paso siguiente (Paso 8: Crear suscripción a eventos).

Paso 7: habilitar el proveedor de recursos de eventos

Dónde: Microsoft Azure Portal

Si es la primera vez que utiliza la cuadrícula de eventos, debe activar el proveedor de recursos de la cuadrícula de eventos.

  1. Seleccione Suscripciones en el menú de la izquierda.
  2. Seleccione la suscripción que está utilizando para la cuadrícula de eventos, es decir, Microsoft Azure Enterprise.
  3. En el menú de la izquierda, en Configuración, seleccione Proveedores de recursos.
  4. Busque Microsoft.EventGrid.
  5. Seleccione Registrarse.

Se tarda un minuto en finalizar la inscripción.

Paso 8: Crear suscripción a evento

Dónde: Microsoft Azure Portal

Para crear una suscripción a eventos, configure la suscripción y especifique el punto final que recibirá las notificaciones.

  1. Seleccione la cuenta de almacenamiento que ha creado en el Paso 2: Crear una cuenta de almacenamiento en Microsoft Azure.
  2. Seleccione el icono Eventos en el panel de navegación de la izquierda.
  3. Haga clic en +Event Subscription.

Aparece la ventana Crear suscripción a evento.

  1. Especifique los siguientes campos en la sección de detalles Suscripción de evento:
    • Nombre: Eventssub. Este es el nombre de la suscripción al evento que creamos.
    • Esquema de evento: esquema de cuadrícula de eventos
  2. Especifique los siguientes campos en la sección Detalles de tema:
    • Tipo de tema: cuenta de almacenamiento
    • Nombre de tema del sistema: eventtopic.
  3. Especifique los siguientes campos en la sección Tipos de eventos:
    • Tipo de evento: MicrosoftStorage.BlobCreated
  4. Especifique los siguientes campos en la sección Detalles de punto final:
  5. Seleccione Crear.

De esta forma, Microsoft Azure crea primero un tema del sistema y, a continuación, la suscripción al evento para el tema.

Paso 9: Confirme que el punto final puede recibir notificaciones

Dónde: página Database Actions: fuentes activas

  1. Vuelva a la página Database Actions Live Feeds y busque la tarjeta para la fuente de tabla activa que está configurando para una fuente basada en notificaciones, como se creó en el Paso 6: Crear y configurar una fuente de tabla activa para utilizar notificaciones y copiar la URL de notificación.
  2. Haga clic en el icono Acciones (tres puntos verticales) de la tarjeta y seleccione Mostrar URL de confirmación.
  3. En el cuadro de diálogo URL de confirmación, haga clic en el enlace para confirmar la URL. Esto no cierra este recuadro de diálogo. Si el enlace se realiza correctamente, se muestra un mensaje que confirma que la suscripción está activa.
    Nota

    El enlace URL de confirmación caduca después de unos minutos. Debe asegurarse de que hace clic en el enlace antes de que caduque.
  4. Vuelva al cuadro de diálogo URL de confirmación y seleccione la casilla de control Comprobar solo cuando haya finalizado el proceso de confirmación del almacén en la nube y haga clic en Aceptar.
Una vez que haya completado los pasos anteriores, cargue un nuevo archivo en el contenedor de Microsoft Azure que creó en el Paso 4: Crear un contenedor.
  1. Navegue hasta el contenedor que ha creado.
  2. Seleccione el contenedor para mostrar una lista de blobs que contiene.
  3. Seleccione el botón Cargar para abrir el repositorio local y examinar el archivo que necesita cargar como blob de bloques.
  4. Seleccione el botón Cargar para cargar el blob.
  5. Ahora puede ver el nuevo blob que se muestra en el contenedor.
  6. Vuelva a la página Database Actions Live Feeds y busque la tarjeta para la fuente de tabla activa que está configurando para una fuente basada en notificaciones.
  7. Haga clic en el icono Acciones (tres puntos verticales) de la tarjeta y seleccione Detalles de ejecución de fuente de tabla activa.

Debe poder ver los logs del blob cargado en la tabla de fuente activa desde el almacenamiento de Microsoft Azure en la ventana Detalles de ejecución de fuente de tabla activa.

Para obtener más información sobre cómo crear un tema y una suscripción en el portal de Azure, consulte Notificaciones de Azure Event Grid.