DBMS_SHARE Constantes

Estas constantes las utiliza el paquete DBMS_SHARE.

Archivos desasociados

Constantes utilizadas por el procedimiento PURGE_DETACHED_FILES.

Nombre Tipo Valor Descripción
PURGE_DROP PLS_INTEGER 1 Intente borrar los archivos con la credencial especificada. Si el archivo no se puede borrar, el archivo sigue apareciendo en las vistas *_SHARE_DETACHED_FILES.
PURGE_DROP_FORCE PLS_INTEGER 2 Intente borrar los archivos con la credencial especificada. El archivo se elimina de las vistas *_SHARE_DETACHED_FILES, incluso si el intento de borrar el archivo falla de nuevo.
PURGE_FORGET PLS_INTEGER 3 Elimine las vistas *_SHARE_DETACHED_FILES de los archivos sin intentar borrarlos.

Nivel de log

Constantes utilizadas para definir el nivel de información recopilada en el log. Estos niveles controlan el número de eventos que se conectan a ALL_SHARE_EVENTS y ALL_SHARE_RECIPIENTS.

Consulte Procedimiento SET_SHARE_LOG_LEVEL y Procedimiento SET_RECIPIENT_LOG_LEVEL.

Nombre Tipo Valor Descripción
LOG_LEVEL_ERRORS_ONLY PLS_INTEGER 0 Registra solo errores.
LOG_LEVEL_BASIC PLS_INTEGER 1 Errores de registro e información básica.
LOG_LEVEL_DETAIL PLS_INTEGER 2 Errores de registro y detalles adicionales.
LOG_LEVEL_DEBUG PLS_INTEGER 3 Registrar el nivel de depuración de información.

Compartir propiedades de trabajo

Propiedades utilizadas en el procedimiento UPDATE_SHARE_JOB_PROPERTY.

Nombre Tipo Valor Descripción
PROP_SHARE_JOB_DOP VARCHAR2(7) 'JOB_DOP' La propiedad JOB_DOP determina cuántos trabajos DBMS_SCHEDULER se utilizan para publicar el recurso compartido. Debe ser un número entre 1 y 5.
PROP_SHARE_JOB_CLASS VARCHAR2(9) 'JOB_CLASS' La propiedad JOB_CLASS determina la clase de trabajo del programador que se utiliza para publicar el recurso compartido. Consulte ALL_SCHEDULER_JOB_CLASSES para obtener una lista de valores válidos. El valor por defecto es DEFAULT_JOB_CLASS.
PROP_SHARE_JOB_PRIORITY VARCHAR2(12) 'JOB_PRIORITY' La propiedad JOB_PRIORITY determina la prioridad relativa cuando dos o más recursos compartidos del mismo usuario se publican al mismo tiempo. El valor debe ser un número, con 0 como valor por defecto. Los recursos compartidos con mayor prioridad se procesarán antes que los recursos compartidos con menor prioridad. Las acciones con la misma prioridad se procesan por orden de llegada.
Valores estándar para prioridad de puesto:
SHARE_PRIORITY_LOW     CONSTANT NUMBER := 1;
SHARE_PRIORITY_DEFAULT CONSTANT NUMBER := 2;
SHARE_PRIORITY_HIGH    CONSTANT NUMBER := 3;

Propiedades de recurso compartido

Constantes utilizadas para indicar las propiedades de un recurso compartido.

Consulte Procedimiento UPDATE_SHARE_PROPERTY, Procedimiento UPDATE_DEFAULT_SHARE_PROPERTY y Función GET_SHARE_PROPERTY.

Nombre Tipo Valor Descripción
PROP_SHARE_DESC VARCHAR2(11) 'DESCRIPTION' Descripción visible localmente del recurso compartido.
PROP_SHARE_PUBLIC_DESC VARCHAR2(18) 'PUBLIC_DESCRIPTION' Descripción visible externamente del recurso compartido.
PROP_SHARE_SPLIT_SIZE VARCHAR2(10) 'SPLIT_SIZE' La propiedad SPLIT_SIZE determina el tamaño de los archivos de parquet generados. El algoritmo funciona de la siguiente manera:
  1. El optimizador SQL estima el tamaño en bytes de un segmento determinado (por ejemplo, una partición de una tabla o los resultados de una vista).
  2. El número de bytes se divide por SPLIT_SIZE y se redondea al alza para producir el "número de divisiones".
  3. A continuación, los datos del segmento se fragmentan en este "número de divisiones" mediante algún método (por ejemplo, ROWID, columnas de índice, columnas especificadas, etc.).
  4. Cada fragmento de datos se convierte en un archivo de parquet.

Tenga en cuenta que el archivo de parquet generalmente será más pequeño que el SPLIT_SIZE debido a la compresión. En particular, SPLIT_SIZE determina la cantidad de datos antes de la compresión.

PROP_SHARE_LOG_LEVEL VARCHAR2(9) 'LOG_LEVEL' La propiedad LOG_LEVEL determina la cantidad de información que se registrará en el log ALL_SHARE_EVENTS.
PROP_SHARE_VERSION_ACCESS VARCHAR2(14) 'VERSION_ACCESS' Las versiones de un recurso compartido publicado que un destinatario puede ver.

Compartir tipo de PAR de destinatario

Estas constantes son los valores válidos para la propiedad PROP_RECIPIENT_PAR_TYPE en el procedimiento UPDATE_RECIPIENT_PROPERTY y el GET_RECIPIENT_PROPERTY.

Nombre Tipo Valor Descripción
PAR_TYPE_FOLDER PLS_INTEGER 1 Las PAR proporcionan acceso a toda la carpeta.
PAR_TYPE_FILE PLS_INTEGER 2 Las PAR proporcionan acceso a un archivo a la vez.

Compartir propiedades de destinatario

Estas constantes se utilizan en Función GET_SHARE_PROPERTY, Procedimiento UPDATE_DEFAULT_SHARE_PROPERTY y Procedimiento UPDATE_SHARE_PROPERTY.

Nombre Tipo Valor Descripción
PROP_RECIPIENT_PAR_LIFETIME VARCHAR2(12) 'PAR_LIFETIME' Duración de las URL de solicitud autenticada previamente enviadas al destinatario a través de la API de uso compartido delta. El valor por defecto es tres horas: '00 03:00:00'
PROP_RECIPIENT_MIN_PAR_LIFETIME VARCHAR2(16) 'MIN_PAR_LIFETIME' Duración mínima garantizada de una URL de solicitud autenticada previamente enviada al destinatario a través de la API de uso compartido delta. Si existe una PAR para el mismo archivo de parquet, se reutiliza solo si la vida útil restante supera este valor mínimo. El valor por defecto es 2 1/2 horas: '00 02:30:00'
PROP_RECIPIENT_MAX_PAR_LIFETIME VARCHAR2(16) 'MAX_PAR_LIFETIME' Configuración de administrador que define el período de vida útil máximo permitido para cualquier destinatario. El valor por defecto es 1 día: '01 00:00:00'
PROP_RECIPIENT_TOKEN_LIFETIME VARCHAR2(14) 'TOKEN_LIFETIME' Una cadena, en formato DÍA INTERVALO A SEGUNDO, que representa la vida útil de un token portador delta sharing. El valor por defecto es una hora: '01 00:00:00'.
PROP_RECIPIENT_MAX_TOKEN_LIFETIME VARCHAR2(18) 'MAX_TOKEN_LIFETIME' Configuración de administrador que define la duración máxima permitida del token de portador para cualquier destinatario. El valor por defecto es 90 días: '90 00:00:00'
PROP_RECIPIENT_EMAIL VARCHAR2(5) 'EMAIL' El correo electrónico del destinatario. Esto solo es necesario para los destinatarios que comparten delta.
PROP_RECIPIENT_DESCRIPTION VARCHAR2(11) 'DESCRIPTION' Descripción textual del destinatario.
PROP_RECIPIENT_LOG_LEVEL VARCHAR2(9) 'LOG_LEVEL' El nivel de registro para el destinatario. Esto controla lo que se registra en USER_SHARE_RECIPIENT_EVENTS. El valor debe ser una de las constantes LOG_LEVEL_*.
PROP_RECIPIENT_SHARING_ID VARCHAR2(10) 'SHARING_ID' ID de uso compartido del destinatario. Esto solo es necesario para los destinatarios de Autonomous Database.
PROP_RECIPIENT_PAR_TYPE VARCHAR2(8) 'PAR_TYPE' Tipo de solicitud autenticada previamente que se va a crear. Debe ser PAR_TYPE_FOLDER (valor por defecto) o PAR_TYPE_FILE.
PROP_RECIPIENT_VERSION_ACCESS VARCHAR2(14) 'VERSION_ACCESS' Especifica qué versiones de los recursos compartidos publicados puede ver un destinatario. Uno de VERSION_ACCESS_CURRENT o VERSION_ACCESS_ANY.

Propiedades de tabla compartida

Constantes utilizadas para indicar las propiedades de la tabla de recursos compartidos. Estos son utilizados por la función GET_SHARE_TABLE_PROPERTY y el procedimiento UPDATE_SHARE_TABLE_PROPERTY.

Nombre Tipo Valor Descripción
PROP_SHARE_TABLE_SPLIT_METHOD VARCHAR2(12) 'SPLIT_METHOD' Especifica cómo se debe dividir un segmento en diferentes archivos.
SPLIT_METHOD_AUTO VARCHAR2(4) 'AUTO' Autonomous Database determina la forma en que se dividen los segmentos.
SPLIT_METHOD_RANGE VARCHAR2(5) 'RANGE' Dividir segmentos en función de los rangos de valores. Los rangos exactos se determinan mediante el análisis de los histogramas de datos. Este método requiere que se especifique uno o más split_columns.
SPLIT_METHOD_ROWID VARCHAR2(5) 'ROWID' Dividir segmentos según ROWID.
SPLIT_METHOD_HASH VARCHAR2(4) 'HASH' Dividir segmentos según los valores HASH. Este método requiere que se especifique uno o más split_columns.
SPLIT_METHOD_VALUE VARCHAR2(5) 'VALUE' Dividir segmentos en función de valores distintos. Este método requiere que se especifique uno o más split_columns.
PROP_SHARE_TABLE_SPLIT_COLUMNS VARCHAR2(13) 'SPLIT_COLUMNS' Especifica las columnas que se utilizan para la división. Estos son necesarios para los métodos RANGE, VALUE y HASH. El valor debe ser un juego delimitado por comas de columnas compartidas (por ejemplo, 'STATE,CITY' o '"STATE","CITY"').
PROP_SHARE_TABLE_ORDER_COLUMNS VARCHAR2(13) 'ORDER_COLUMNS' Especifica qué columnas se utilizan para ordenar al recopilar parquet. El valor debe ser un juego delimitado por comas de columnas compartidas (por ejemplo, 'STATE,CITY' o '"STATE","CITY"').
PROP_SHARE_TABLE_SHARE_COLUMNS VARCHAR2(13) 'SHARE_COLUMNS' Especifica qué columnas se comparten. El valor es un juego delimitado por comas de columnas compartidas. Por ejemplo, 'estado, ciudad' o '"ESTADO","Ciudad"'.
PROP_SHARE_TABLE_SPLIT_SIZE VARCHAR2(10) 'SPLIT_SIZE' Sustituya el nivel de recurso compartido split_size para una tabla específica. El valor es un número.
PROP_SHARE_TABLE_GATHER_STATS VARCHAR2(12) 'GATHER_STATS' Si Autonomous Database recopila estadísticas, el valor de 'GATHER_STATS' es 'YES'. En caso contrario, el valor es 'NO'.
PROP_SHARE_TABLE_SPLIT_ROWS VARCHAR2(10) 'SPLIT_ROWS' La propiedad SPLIT_ROWS es una forma alternativa de especificar la cantidad de datos que se van a almacenar en cada archivo de parquet.
  1. Autonomous Database calcula el número de filas de un segmento determinado (por ejemplo, una partición de una tabla o los resultados de una vista).
  2. El número de filas se divide entre SPLIT_ROWS y se redondea al alza para producir el "número de divisiones".
  3. A continuación, los datos del segmento se fragmentan en este número de divisiones mediante algún método (por ejemplo, ROWID, columnas de índice, columnas especificadas, etc.).
  4. Cada fragmento de datos se convierte en un archivo de parquet.

Se recomienda utilizar la propiedad SPLIT_SIZE para controlar el número de divisiones, ya que esto refleja la cantidad de datos en cada fila. Una fila con 900 columnas de VARCHAR2(4000), por ejemplo, es mucho mayor que una fila con una sola columna de tipo NUMBER(1).

Utilice solo SPLIT_ROWS si ha contabilizado la cantidad media de datos en cada fila.

PROP_SHARE_TABLE_FLASHBACK VARCHAR2(9) 'FLASHBACK' La propiedad FLASHBACK determina si la tabla se publicará mediante consultas de FLASHBACK para garantizar la consistencia de lectura entre los diferentes archivos de exportación. El valor debe ser YES, NO o AUTO.

La configuración AUTO utilizará flashback si está disponible.

La configuración YES hará que la publicación falle si no se puede realizar un flashback en la tabla o vista.

La configuración NO no utilizará flashback, lo que significa que los archivos de parquet pueden representar diferentes instantáneas de los datos.

Tipos de uso compartido

Constantes utilizadas durante la creación del recurso compartido para identificar el tipo de recurso compartido.

Consulte CREATE_SHARE Procedure.

Nombre Tipo Valor Descripción
SHARE_TYPE_VERSIONED DBMS_ID 'VERSIONED' El recurso compartido se utiliza para compartir datos con versiones.
SHARE_TYPE_LIVE DBMS_ID 'LIVE' El recurso compartido se utiliza para compartir datos activos.

Tipo de ID de uso compartido

Se utiliza en ASSERT_SHARING_ID y GET_SHARING_ID.

Nombre Tipo Valor Descripción
SHARING_ID_TYPE_TENANCY VARCHAR2(7) 'TENANCY' El ID de uso compartido representa un arrendamiento de OCI.
SHARING_ID_TYPE_COMPARTMENT VARCHAR2(11) 'COMPARTMENT' El ID de uso compartido representa un compartimento de OCI.
SHARING_ID_TYPE_DATABASE VARCHAR2(8) 'DATABASE' El ID de uso compartido representa una instancia de OCI Autonomous Database.
SHARING_ID_TYPE_REGION VARCHAR2(6) 'REGION' El ID de uso compartido representa una región de OCI.

Acceso a versión

Valores posibles para la propiedad de recurso compartido VERSION_ACCESS. Esto se utiliza para implementar delta "viaje en el tiempo". Estos son los valores válidos asociados a PROP_SHARE_VERSION_ACCESS y PROP_RECIPIENT_VERSION_ACCESS.

Se pueden utilizar para activar la propiedad "version" en el punto final de consulta de uso compartido delta, que permite a los destinatarios seleccionar versiones específicas de los datos en lugar de recibir siempre la versión ACTUAL. Debe activar esto tanto en el recurso compartido como en el destinatario.

Por ejemplo:
UPDATE_SHARE_PROPERTY(
          share_name => '...',
          share_property => DBMS_SHARE.PROP_SHARE_VERSION_ACCESS,
          new_value => DBMS_SHARE.VERSION_ACCESS_ANY);

UPDATE_SHARE_PROPERTY(
          share_name => '...',
          share_property => DBMS_SHARE.PROP_RECIPIENT_VERSION_ACCESS,
          new_value => DBMS_SHARE.VERSION_ACCESS_ANY);
Nombre Tipo Valor Descripción
VERSION_ACCESS_CURRENT PLS_INTEGER 1 Un destinatario solo puede ver la versión actual. (Valor por defecto)
VERSION_ACCESS_ANY PLS_INTEGER 2 Un destinatario puede elegir cualquier versión ACTUAL o RETIRADA.