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:
|
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:
Tenga en cuenta que el archivo de parquet generalmente será más pequeño que el |
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.
Se recomienda utilizar la propiedad Utilice solo |
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 La configuración La configuración |
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.
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. |