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 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: 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 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 AI 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'`	La base de datos de IA autónoma 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 la base de datos de IA autónoma 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. La base de datos de IA autónoma 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 entre `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 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 base de datos de IA autónoma de OCI.
`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.

Documentación de Oracle Cloud Infrastructure

DBMS_SHARE Constantes