Creación de la base de datos del historial enriquecido
Este tema contiene información que le ayudará a especificar una conexión a la base de datos Oracle y a seleccionar canales para crear la base de datos de historial enriquecida. Utilizará esta base de datos para realizar informes analíticos y visualizaciones de las actividades de su libro mayor.
¿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 de Oracle como Oracle Autonomous Data Warehouse u Oracle Database Classic Cloud Service con Oracle Cloud Infrastructure para crear su base de datos de historial enriquecido. Utilice la consola de Oracle Blockchain Platform 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 proporciona 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 enriquecida. 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
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 seleccionar los canales con los datos del libro mayor de código de cadenas que desea escribir en la base de datos de historial enriquecida. Por defecto, los canales no están activados para escribir datos en la base de datos de historial enriquecida.
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.
- 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.
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.
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.
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.
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.
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.
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.