Creación de la base de datos del historial enriquecido

¿Qué es la base de datos de historial enriquecido?

La base de datos de historial enriquecida es externa a Oracle Blockchain Platform y contiene datos sobre las transacciones del libro mayor de blockchain en los canales que seleccione. Esta base de datos se utiliza para crear informes de análisis y visualizar las actividades del libro mayor.

Por ejemplo, con la base de datos de historial enriquecida, puede crear análisis para conocer el saldo medio de todos los clientes de su banco durante algún intervalo de tiempo, o cuánto tiempo tardó en enviar la mercancía de un mayorista a un minorista.

Internamente, Oracle Blockchain Platform utiliza la base de datos de historial de Hyperledger Fabric para gestionar la información de transacciones del libro mayor y del libro mayor actual en la consola. Solo los códigos de cadenas pueden acceder a esta base de datos de historial y no puede exponer la base de datos de historial de Hyperledger Fabric como origen de datos para consultas analíticas. La base de datos de historial enriquecida utiliza una base de datos Oracle externa y contiene muchos detalles sobre cada transacción confirmada en un canal. Este nivel de recopilación de datos hace que la base de datos de historial enriquecida sea una excelente fuente de datos para análisis. Para obtener información sobre los datos que recopila la base de datos de historial enriquecido, consulte Tablas y columnas de base de datos de historial enriquecido.

Solo puede utilizar una base de datos Oracle como Oracle Autonomous Data Warehouse u Oracle Database Classic Cloud Service con Oracle Cloud Infrastructure para crear su base de datos de historial enriquecida. La consola de Oracle Blockchain Platform se utiliza para proporcionar la cadena de conexión y las credenciales para acceder a la base de datos Oracle y escribir en ella. Tenga en cuenta que las credenciales que proporcione son las credenciales de la base de datos y Oracle Blockchain Platform no las gestiona. Después de crear la conexión, seleccionará los canales que contienen los datos del libro mayor que desea incluir en la base de datos de historial enriquecido. Consulte Activación y configuración de la base de datos de historial enriquecido.

Puede utilizar tablas estándar o tablas de blockchain para almacenar la base de datos de historial enriquecida. Las tablas de blockchain son tablas de solo adición a prueba de alteraciones, que se pueden utilizar como un libro mayor seguro mientras que también están disponibles para transacciones y consultas con otras tablas. Para obtener más información, consulte Tabla de Oracle Blockchain.

Puede utilizar cualquier herramienta de análisis, como Oracle Analytics Cloud u Oracle Data Visualization Cloud Service, para acceder a la base de datos de historial enriquecida y crear informes de análisis o visualizaciones de datos.

Creación de la cadena de conexión de Oracle Database Classic Cloud Service

Debe recopilar información de Oracle Database Classic Cloud Service desplegado en Oracle Cloud Infrastructure para crear la cadena de conexión necesaria para la base de datos de historial enriquecido. También debe activar el acceso a la base de datos mediante el puerto 1521.

Búsqueda y registro de información de Oracle Database Classic Cloud Service

La información necesaria para crear una conexión a Oracle Database Classic Cloud Service está disponible en la consola de Oracle Cloud Infrastructure.

En la consola de Infrastructure, haga clic en el menú de navegación de la esquina superior izquierda y, a continuación, en Base de datos.
Busque la base de datos a la que desea conectarse y registre la dirección IP pública.
Haga clic en el nombre de la base de datos a la que desea conectarse y registre los valores en estos campos:
- Nombre único de la base de datos
- Nombre de dominio de host
- Puerto
Busque un nombre de usuario y una contraseña de un usuario de base de datos con permisos para leer en esta base de datos y anótelos. Por ejemplo, el usuario SYSTEM.

Activación del acceso a base de datos a través del puerto 1521

Agregue una regla de entrada que permita a la base de datos de historial enriquecido acceder a la base de datos a través del puerto 1521.

En la página inicial de Oracle Cloud Infrastructure, haga clic en el icono de navegación y, a continuación, en Bases de datos, haga clic en Sistemas de base de datos.
Haga clic en la base de datos a la que desea conectarse.
Haga clic en el enlace Red virtual en la nube.
Vaya a la subred adecuada y, a continuación, en Listas de seguridad, haga clic en Lista de seguridad por defecto para <Target Database>.

Aparece la página Security List.
Haga clic en Editar todas las reglas.
Agregue una regla de entrada para permitir cualquier tráfico entrante de Internet pública a través del puerto 1521 en este nodo de base de datos, con los siguientes valores:
- CIDR DE ORIGEN: 0.0.0.0/0
- PROTOCOLO IP: TCP
- Rango de puertos de origen: Todos
- RANGO DE PUERTOS DE DESTINO: 1521
- Permite: tráfico TCP para los puertos: 1521

Creación de la cadena de conexión

Después de activar el acceso a la base de datos Oracle, utilice la información recopilada para crear la cadena de conexión en el cuadro de diálogo Configurar historial enriquecido.

Cree la cadena de conexión con la siguiente sintaxis: <publicIP>:<portNumber>/<database unique name>.<host domain name>

Por ejemplo, 192.0.2.0:1521/CustDB_iad1vm.sub05031027070.customervcnwith.oraclevcn.example.com

Asegúrese de que el usuario de la base de datos tiene los privilegios adecuados

Para que la funcionalidad de historial enriquecido pueda gestionar sus sesiones de base de datos y recuperarse del tiempo de inactividad temporal de la base de datos o de la red, asegúrese de que el usuario de base de datos registrado con Oracle Blockchain Platform tenga los dos privilegios siguientes:

grant select on v_$session to <user>;
grant alter system to <user>;

Además, si la base de datos de historial enriquecido utiliza Oracle Autonomous Data Warehouse, el usuario de la base de datos debe tener el siguiente privilegio:

grant unlimited tablespace to <user>;

Si el usuario de la base de datos no tiene esos privilegios, el administrador de la base de datos del sistema los debe otorgar.

Sin estos privilegios, Oracle Blockchain Platform puede replicarse en la base de datos, pero no puede recuperarse de situaciones que provocan una sesión de base de datos dañada, lo que evita que el historial enriquecido se ponga al día con las transacciones recientes durante un período prolongado. Sin estos privilegios en Oracle Autonomous Data Warehouse, no se guardan datos de historial enriquecidos.

Activación y configuración de la base de datos de historial enriquecido

Utilice la consola para proporcionar información de conexión a la base de datos y seleccione los canales con los datos del libro mayor del código de cadenas que desea escribir en la base de datos de historial enriquecido. Por defecto, los canales no están activados para escribir datos en la base de datos de historial enriquecido.

Tenga en cuenta la siguiente información:

Cada miembro de la red de blockchain configura su propia base de datos de historial enriquecida.
Debe utilizar una base de datos Oracle. No se admiten otros tipos de base de datos.
Cada canal que escribe en la base de datos de historial enriquecido debe contener al menos un nodo peer.

Introduzca la información de conexión y credencial para la base de datos Oracle que desea utilizar para almacenar información de historial enriquecida.
1. Vaya a la consola, haga clic en el botón Opciones y haga clic en Configurar historial enriquecido. Este botón se encuentra encima de la barra que contiene los separadores que se utilizan para navegar a los nodos, canales y códigos de cadenas.
  Aparece el cuadro de diálogo Configurar historial enriquecido.
2. Introduzca el nombre de usuario y la contraseña necesarios para acceder a la base de datos Oracle.
3. En el campo Cadena de conexión, introduzca la cadena de conexión de la base de datos que utilizará para almacenar datos de historial enriquecidos. Lo que introduzca aquí dependerá de la base de datos Oracle que utilice.
  - Si utiliza Oracle Autonomous Data Warehouse, introducirá algo similar a <username>adw_high. Para buscar la información de conexión de Oracle Autonomous Data Warehouse, vaya al archivo ZIP de la cartera de credenciales y abra su archivo TNS.
  - Si utiliza Oracle Database Classic Cloud Service con Oracle Cloud Infrastructure, consulte Creación de la cadena de conexión de Oracle Database Classic Cloud Service.
  - Si utiliza una base de datos Oracle no autónoma (una base de datos que no utiliza una cartera de credenciales) y desea utilizar el usuario sys para conectarse a la base de datos, debe agregar ?as=sys[dba|asm|oper] a la cadena de conexión. Por ejemplo, 123.123.123.123:1521/example.oraclevcn.com?as=sysdba
4. Si utiliza una instancia de base de datos autónoma de Oracle Cloud (por ejemplo, Oracle Autonomous Data Warehouse u Oracle Autonomous Transaction Processing), utilice el campo Archivo de paquete de cartera para cargar el archivo ZIP de cartera de credenciales necesario. Este archivo contiene credenciales de cliente y se genera a partir de la base de datos autónoma de Oracle.
  
  Note:
  Al volver a abrir el cuadro de diálogo Configurar historial enriquecido después de configurar el historial enriquecido, no se muestra el nombre del archivo de cartera. Si actualiza otros valores, debe volver a cargar el archivo ZIP de cartera antes de hacer clic en Guardar. Si hace clic en Guardar mientras no se muestra ningún nombre de archivo de cartera, la configuración se actualiza para no utilizar un archivo de cartera.
5. Para utilizar tablas de blockchain para almacenar la base de datos de historial enriquecida, seleccione Usar tabla de blockchain de base de datos.
  La base de datos subyacente debe soportar tablas de blockchain.
  - Para especificar el número de días que se conservarán las tablas y filas, seleccione Configuración básica y, a continuación, introduzca el número de días que se conservarán las tablas y filas. Introduzca 0 para conservar las tablas o filas de forma permanente. Para evitar más cambios en los valores de retención, seleccione Bloqueado.
  - Para especificar la retención de tablas y filas mediante una sentencia de lenguaje de definición de datos (DDL), seleccione Consulta de configuración avanzada y, a continuación, introduzca la sentencia DDL.
6. Haga clic en Guardar.
Active el historial enriquecido en los canales que contienen los datos de código de cadenas que desea escribir en la base de datos de historial enriquecida.
1. Vaya a la consola y seleccione el separador Canales.
2. Busque el canal que contiene los datos de código de cadenas que desea escribir en la base de datos de historial enriquecida. Haga clic en el botón Más opciones y seleccione Configurar historial enriquecido.
  Se muestra el cuadro de diálogo Configurar historial enriquecido.
3. Haga clic en la casilla de control Activar historial enriquecido. Para almacenar recopilaciones de datos privados en la base de datos de historial enriquecido, introduzca una lista de nombres de recopilación de datos privados, separados por comas. Para obtener más información sobre las recopilaciones de datos privados, consulte ¿Qué son las recopilaciones de datos privados?. Para agregar detalles de transacción a la base de datos de historial enriquecido, seleccione los detalles que desea agregar. Haga clic en Guardar.

La base de datos de historial enriquecido está configurada, pero las tablas no se crean en la base de datos inmediatamente. Cuando se produce el siguiente cambio relevante de transacción o libro mayor, las tablas se crean en la base de datos de historial enriquecida.

Modificación de la conexión a la base de datos del historial enriquecido

Puede cambiar la información de conexión de la base de datos de historial enriquecido.

Después de crear tablas en la base de datos para un canal, la modificación de la configuración del historial enriquecido para el canal no tiene ningún efecto, incluso después de hacer clic en Guardar, a menos que cambie el nombre de usuario y la contraseña o la cadena de conexión. Si cambia el nombre de usuario y la contraseña, las tablas se crean en la misma base de datos. Si cambia la cadena de conexión y las credenciales, se configura una base de datos diferente y se crean tablas después de la siguiente transacción o cambio de libro mayor relevante. No puede cambiar una base de datos de historial enriquecida de tablas estándar a tablas de blockchain y no puede cambiar los tiempos de retención, a menos que también cambie las credenciales o la cadena de conexión.

Vaya a la consola, haga clic en el botón Opciones y haga clic en Configurar historial enriquecido. Este botón se encuentra encima de la barra que contiene los separadores que se utilizan para navegar a los nodos, canales y códigos de cadenas.
Si es necesario, actualice el nombre de usuario y la contraseña necesarios para acceder a la base de datos Oracle.
Si es necesario, en el campo Cadena de conexión, modifique la cadena de conexión de la base de datos que utilizará para almacenar datos de historial enriquecidos. Lo que introduzca aquí dependerá de la base de datos Oracle que utilice.
- Si utiliza Oracle Autonomous Data Warehouse, introducirá algo similar a <username>adw_high. Para buscar la información de conexión de Oracle Autonomous Data Warehouse, vaya al archivo ZIP de la cartera de credenciales y abra su archivo TNS.
- Si utiliza Oracle Database Classic Cloud Service con Oracle Cloud Infrastructure, consulte Creación de la cadena de conexión de Oracle Database Classic Cloud Service.
- Si utiliza una base de datos Oracle no autónoma (una base de datos que no utiliza una cartera de credenciales) y desea utilizar el usuario sys para conectarse a la base de datos, debe agregar ?as=sys[dba|asm|oper] a la cadena de conexión. Por ejemplo, 123.123.123.123:1521/example.oraclevcn.com?as=sysdba
Si utiliza una instancia de base de datos autónoma de Oracle Cloud (por ejemplo, Oracle Autonomous Data Warehouse u Oracle Autonomous Transaction Processing), utilice el campo Archivo de paquete de cartera para cargar o volver a cargar el archivo de cartera de credenciales necesario. Este archivo contiene credenciales de cliente y se genera a partir de la base de datos autónoma de Oracle.

Note:
Al volver a abrir el cuadro de diálogo Configurar historial enriquecido después de configurar el historial enriquecido, no se muestra el nombre del archivo de cartera. Si actualiza otros valores, debe volver a cargar el archivo ZIP de cartera antes de hacer clic en Guardar. Si hace clic en Guardar mientras no se muestra ningún nombre de archivo de cartera, la configuración se actualiza para no utilizar un archivo de cartera.
Para utilizar tablas de blockchain para almacenar la base de datos de historial enriquecida, seleccione Usar tabla de blockchain de base de datos.
La base de datos subyacente debe soportar tablas de blockchain.
- Para especificar el número de días que se conservarán las tablas y filas, seleccione Configuración básica y, a continuación, introduzca el número de días que se conservarán las tablas y filas. Introduzca 0 para conservar las tablas o filas de forma permanente. Para evitar más cambios en los valores de retención, seleccione Bloqueado.
- Para especificar la retención de tablas y filas mediante una sentencia de lenguaje de definición de datos (DDL), seleccione Consulta de configuración avanzada y, a continuación, introduzca la sentencia DDL.
Haga clic en Guardar.

Configuración de los canales que escriben datos en la base de datos de historial enriquecida

Puede activar canales para escribir datos del libro mayor de código de cadenas en la base de datos de historial enriquecida, así como evitar que los canales escriban datos en la base de datos de historial enriquecida. También puede configurar un canal individual para utilizar una configuración de base de datos de historial enriquecido diferente a la configuración global.

Debe especificar la información global para conectarse a la base de datos de historial enriquecido antes de seleccionar canales que escriban en la base de datos de historial enriquecido. Consulte Activación y configuración de la base de datos de historial enriquecido.

Después de crear tablas en la base de datos para un canal, la modificación de la configuración del historial enriquecido para el canal no tiene ningún efecto, incluso después de hacer clic en Guardar, a menos que cambie el nombre de usuario y la contraseña o la cadena de conexión. Si cambia el nombre de usuario y la contraseña, las tablas se crean en la misma base de datos. Si cambia la cadena de conexión y las credenciales, se configura una base de datos diferente y se crean tablas después de la siguiente transacción o cambio de libro mayor relevante. No puede cambiar una base de datos de historial enriquecida de tablas estándar a tablas de blockchain y no puede cambiar los tiempos de retención, a menos que también cambie las credenciales o la cadena de conexión.

Vaya a la consola y seleccione el separador Canales.
Busque el canal para el que desea modificar el acceso. Haga clic en el botón Más opciones y seleccione Configurar historial enriquecido.
Se muestra el cuadro de diálogo Configurar historial enriquecido.
Para activar la recopilación de datos de historial enriquecidos para el canal, seleccione la casilla de control Activar historial enriquecido. Para desactivar la recopilación de datos de historial enriquecidos para el canal, desactive la casilla de control Activar historial enriquecido.
Para configurar el canal para recopilar datos de historial enriquecidos mediante una base de datos diferente o valores diferentes, seleccione Usar configuración de nivel de canal y, a continuación, especifique los valores que desea utilizar.
Para obtener más información sobre los valores del historial enriquecido, consulte Activación y configuración de la base de datos del historial enriquecido.
Haga clic en Guardar.

Supervisión del estado del historial enriquecido

Después de configurar la base de datos de historial enriquecido, puede utilizar la consola para supervisar el estado de replicación del historial enriquecido.

Vaya a la consola y seleccione el separador Canales.
En la tabla de canales, haga clic en el botón Más acciones del canal que desea supervisar y, a continuación, haga clic en Estado de historial enriquecido.
Se muestra el cuadro de diálogo Rich History Status (Estado de historial enriquecido), que incluye detalles sobre el estado de replicación y configuración.
Haga clic en Actualizar para mostrar el último estado.

Limitar acceso a historial enriquecido

Puede utilizar políticas de canal y listas de control de acceso (ACL) para limitar las organizaciones que pueden configurar la base de datos de historial enriquecido y recuperar información de configuración o estado de historial enriquecido.

Por defecto, todas las organizaciones que tienen acceso administrativo a un canal pueden configurar la recopilación de historial enriquecido y pueden recuperar el estado de historial enriquecido y los detalles de configuración. Para limitar este acceso, por ejemplo, a la organización fundadora, cree una política de canal y aplique la política a los recursos que controlan el acceso.

Vaya a la consola y seleccione el separador Canales.
Se muestra el separador Canales. La tabla de canales contiene una lista de todos los canales de la red.
En la tabla de canales, haga clic en el nombre del canal en el que desea limitar el acceso.
Haga clic en Políticas de canal y, a continuación, cree una política de firma que incluya los miembros de la organización que accederán a las funciones de historial enriquecidas.
Para obtener más información sobre las políticas de canal, consulte Work With Channel Policies and ACLs.

Por ejemplo, cree una política que incluya solo la identidad de la organización fundadora, no la identidad de ninguna organización participante.
Haga clic en ACL.

En la tabla Recursos, busque el recurso que desea actualizar para utilizar la nueva política. Haga clic en Ampliar para el recurso y, a continuación, seleccione la política que desea asignar al recurso

En la siguiente tabla, se muestran los recursos que controlan el acceso al historial enriquecido.

Recurso	Control de Acceso
`obpadmin/ConfigureRichHistoryChannel`	Controla la configuración, la activación y la desactivación del historial enriquecido de un canal.
`obpadmin/GetRichHistoryChannelStatus`	Controla la recuperación del estado de replicación del historial enriquecido para un canal.
`obpadmin/GetRichHistoryChannelConfig`	Controla la recuperación de la configuración actual del historial enriquecido para un canal.

Haga clic en Actualizar ACL.

El rico acceso a la historia ahora está controlado por la nueva política. Los miembros de la organización que no estén incluidos en la nueva política recibirán un mensaje de error cuando intenten acceder a un recurso controlado por la política.

Tablas y columnas de base de datos de historial enriquecido

La base de datos de historial enriquecida contiene tres tablas para cada canal: historial, estado y altura más reciente. Consultará las tablas de historial y estado al crear análisis sobre las transacciones del libro mayor de los códigos de cadenas. Si ha seleccionado seleccionar cualquiera de los detalles de transacción al activar el historial enriquecido, se creará una tabla adicional con los detalles de transacción.

Tabla de Historial

La tabla_hist <instanceName><channelName> contiene el historial de libros mayores. Los datos de esta tabla indican el ID de código de cadena, la clave utilizada, si la transacción era válida, el valor asignado a la clave, etc.

Tenga en cuenta que las columnas value y valueJson se utilizan de forma mutuamente excluyente. Es decir, cuando un valor clave es json válido, el valor se define en la columna valueJson. De lo contrario, el valor se establece en la columna value. La columna valueJson se configura como una columna json en la base de datos, lo que significa que los usuarios pueden consultar esa columna mediante las extensiones específicas habituales de Oracle JSON.

Si se configuran, los datos privados también se almacenan en esta tabla. Para los datos privados, el ID de código de cadena utiliza el siguiente formato: <chaincodeName>$$<collectionName>.

Columna	Tipo de dato
chaincodeId	VARCHAR2 (256)
clave	VARCHAR2 (1024)
txnIsValid	NÚMERO (1)
value	VARCHAR2 (4000)
valueJson	CLOB
blockNo	NÚMERO NO NULO
NÚMERO txnNo	NOT NULL
txnId	VARCHAR2 (128)
txnTimestamp	TIMESTAMP
txnIsDelete	NÚMERO (1)

Tabla de Estados

La tabla <instanceName><channelName>_state contiene valores de datos replicados desde la base de datos de estado. Consultará la tabla de estado cuando cree análisis sobre el estado del libro mayor.

Tenga en cuenta que las columnas value y valueJson se utilizan de forma mutuamente excluyente. Es decir, cuando un valor clave es json válido, el valor se define en la columna valueJson. De lo contrario, el valor se establece en la columna value. La columna valueJson se configura como una columna json en la base de datos, lo que significa que los usuarios pueden consultar esa columna mediante las extensiones específicas habituales de Oracle JSON.

Columna	Tipo de dato
chaincodeId	VARCHAR2 (256)
clave	VARCHAR2 (1024)
value	VARCHAR2 (4000)
valueJson	CLOB
blockNo	NUMBER
txnNo	NUMBER

Última tabla de altura

La tabla <instanceName><channelName>_last la utiliza internamente Oracle Blockchain Platform para realizar un seguimiento de la altura del bloque registrada en la base de datos de historial enriquecido. Determina qué tan actual es la base de datos de historial enriquecido y si todas las transacciones de código de cadenas se registraron en la base de datos de historial enriquecido. No puede consultar esta base de datos para análisis.

Tabla de detalles de transacción

La tabla <instanceName><channelName>_more contiene atributos relacionados con transacciones confirmadas. Al activar la base de datos de historial enriquecida, puede seleccionar cuáles de estos atributos desea registrar en esta tabla. La tabla de detalles de transacción solo captura información sobre transacciones de endosador, no transacciones de configuración ni ningún otro tipo de transacciones de Hyperledger Fabric.

Columna	Tipo de dato
ID DE CÓDIGO DE CADENA	VARCHAR2 (256)
BLOQUEAR	NUMBER
TXNNO	NUMBER
ID de transacción	VARCHAR2(128)
REGISTRO DE HORA DE TRANSACCIÓN	TIMESTAMP
ENVIAR	VARCHAR2(512)
REMITENTE	VARCHAR2(512)
REMITENTE	VARCHAR2(512)
TIPO DE CÓDIGO DE CADENA	VARCHAR2(32)
NOMBRE DE CÓDIGO DE VALIDACIÓN	VARCHAR2(32)
APROBACIÓN	CLOB
ENTRADAS	CLOB
EVENTOS	CLOB
ESTADO DE RESPUESTA	NÚMERO(0)
CARGA ÚTIL DE RESPUESTA	VARCHAR2(1024)
RWSET	CLOB
BLOCKCREATORCN	VARCHAR2(512)
BLOCKCREATORORG	VARCHAR2(512)
BLOCKCREATOROU	VARCHAR2(512)
NÚMERO DE BLOQUE DE CONFIGURACIÓN	NÚMERO(0)
CONFIGBLOCKCREATORCN	VARCHAR2(512)
CONFIGBLOCKCREATORORG	VARCHAR2(512)
CONFIGBLOCKCREATOROU	VARCHAR2(512)

Note:

La organización (ORG) y la unidad de organización (OU) están controladas por certificados de identidad, lo que implica que se pueden asignar a varios valores. Se capturan como una lista separada por comas en los valores de la tabla.
Para las identidades, la tabla incluye información solo sobre la parte "Asunto" de los certificados, no sobre el "Emisor".
La columna RWSET contiene operaciones en todos los códigos de cadena (en el mismo libro mayor) realizados durante el endoso. Como tal, normalmente verá tanto las operaciones de lectura de lscc como las operaciones de espacio de nombres de código de cadena reales.