DBMS_SHARE Constantes

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 vuelve a fallar.
`PURGE_FORGET`	`PLS_INTEGER`	`3`	Elimine las vistas `*_SHARE_DETACHED_FILES` de los archivos sin intentar borrarlas.

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`	Registre sólo los errores.
`LOG_LEVEL_BASIC`	`PLS_INTEGER`	`1`	Registrar errores e información básica.
`LOG_LEVEL_DETAIL`	`PLS_INTEGER`	`2`	Registrar errores y detalles adicionales.
`LOG_LEVEL_DEBUG`	`PLS_INTEGER`	`3`	Registra el nivel de depuración de la información.

Compartir propiedades de puesto

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 se publican dos o más recursos compartidos del mismo usuario al mismo tiempo. El valor debe ser un número, con 0 como valor por defecto. Los recursos compartidos con una prioridad más alta se procesarán antes que los recursos compartidos con una prioridad más baja. Los recursos compartidos con la misma prioridad se procesan por orden de llegada. Valores estándar para prioridad de trabajo: `SHARE_PRIORITY_LOW CONSTANT NUMBER := 1; SHARE_PRIORITY_DEFAULT CONSTANT NUMBER := 2; SHARE_PRIORITY_HIGH CONSTANT NUMBER := 3;`

Compartir propiedades

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 localmente visible 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 es el siguiente: 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). El número de bytes se divide por `SPLIT_SIZE` y se redondea al alza para producir el "número de divisiones". 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.). Cada fragmento de datos se convierte en un archivo de parquet. Tenga en cuenta que el archivo de parquet suele ser más pequeño que `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 puede ver un destinatario.

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 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.

Propiedades de destinatarios compartidos

Estas constantes se utilizan en la función GET_SHARE_PROPERTY, el procedimiento UPDATE_DEFAULT_SHARE_PROPERTY y el 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 mediante la API de uso compartido delta. El valor por defecto es de 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 mediante la API de uso compartido delta. Si existe una PAR para el mismo archivo de parquet, solo se reutiliza 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 la duración mínima máxima permitida 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 INTERVAL DAY TO SECOND, que representa la duración de un token de portador de delta compartido. El valor por defecto es una hora: '01 00:00:00'.
`PROP_RECIPIENT_MAX_TOKEN_LIFETIME`	`VARCHAR2(18)`	`'MAX_TOKEN_LIFETIME'`	Valor 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 de uso compartido delta.
`PROP_RECIPIENT_DESCRIPTION`	`VARCHAR2(11)`	`'DESCRIPTION'`	Descripción de texto del destinatario.
`PROP_RECIPIENT_LOG_LEVEL`	`VARCHAR2(9)`	`'LOG_LEVEL'`	El nivel de registro del 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'`	El 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 recursos compartidos publicados puede ver un destinatario. Uno de `VERSION_ACCESS_CURRENT` o `VERSION_ACCESS_ANY`.

Propiedades de tablas de recursos compartidos

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 según los rangos de valores. Los rangos exactos se determinan mediante el análisis de los histogramas de datos. Este método necesita 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 necesita que se especifique uno o más `split_columns`.
`SPLIT_METHOD_VALUE`	`VARCHAR2(5)`	`'VALUE'`	Dividir segmentos según valores distintos. Este método necesita 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 las columnas que 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 las columnas que se comparten. El valor es un juego delimitado por comas de columnas compartidas. Por ejemplo, 'STATE,CITY' o '"STATE","CITY"'.
`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'.` De lo 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. 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). El número de filas se divide por `SPLIT_ROWS` y se redondea al alza para producir el "número de divisiones". 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.). 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 refleja la cantidad de datos en cada fila. Una fila con 900 columnas de `VARCHAR2(4000)`, por ejemplo, es mucho más grande que una fila con una sola columna de tipo `NUMBER(1)`. Utilice `SPLIT_ROWS` solo 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`. El valor `AUTO` utilizará el flashback si está disponible. El valor `YES` hará que la publicación falle si no es posible 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.

Compartir Tipos

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

Consulte Procedimiento CREATE_SHARE.

Nombre	Tipo	Valor	Descripción
`SHARE_TYPE_VERSIONED`	`DBMS_ID`	`'VERSIONED'`	El recurso compartido se utiliza para compartir datos versionados.
`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 Autonomous Database de OCI.
`SHARING_ID_TYPE_REGION`	`VARCHAR2(6)`	`'REGION'`	El ID de uso compartido representa una región de OCI.

Acceso a la versión

Posibles valores 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. (Defecto)
`VERSION_ACCESS_ANY`	`PLS_INTEGER`	`2`	Un destinatario puede elegir cualquier versión actual o reiniciada.

Documentación de Oracle Cloud Infrastructure