Documentación de Oracle Cloud Infrastructure

Resumen de subprogramas de productor de recursos compartidos

En esta tabla, se muestran las funciones y los procedimientos del paquete DBMS_SHARE utilizados para producir recursos compartidos para destinatarios.

Subprograma Descripción
Procedimiento ADD_TO_SHARE Agregue una tabla o vista a un recurso compartido.
Procedimiento ASSERT_SHAREABLE_OBJECT Devolver sin errores, si el objeto existe y se puede compartir.
Procedimiento ASSERT_SHARING_ID Ejecute comprobaciones de validación básicas en un ID de uso compartido y devuelva una en formato canónico.
Función CAN_CREATE_SHARE Esta función comprueba si el esquema actual puede crear destinatarios de recursos compartidos.
Función CAN_CREATE_SHARE_RECIPIENT Esta función comprueba si el esquema actual puede crear destinatarios de recursos compartidos.
Procedimiento CLEAR_RECIPIENT_EVENTS Borre los eventos del registro de eventos del destinatario compartido.
Procedimiento CLEAR_SHARE_EVENTS Borre los eventos del log de eventos compartidos.
Procedimiento CREATE_BEARER_TOKEN_CREDENTIAL Cree una credencial adecuada para su uso con proveedores de recursos compartidos delta.
Procedimiento CREATE_CLOUD_STORAGE_LINK Cree un enlace URI de almacenamiento en la nube con nombre.
Procedimiento CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Cree o sustituya un URI de almacenamiento en la nube con nombre.
Procedimiento CREATE_OR_REPLACE_SHARE_RECIPIENT Cree o sustituya un destinatario compartido.
Procedimiento CREATE_SHARE Cree un objeto compartido con nombre.
Procedimiento CREATE_SHARE_RECIPIENT Cree un nuevo destinatario de recursos compartidos.
Procedimiento DROP_CLOUD_STORAGE_LINK Borre un enlace de almacenamiento en la nube.
Procedimiento DROP_RECIPIENT Borrar un destinatario.
Procedimiento DROP_SHARE Soltar un recurso compartido y todo su contenido.
Procedimiento DROP_SHARE_LINK_VIEW Borre una vista creada mediante el procedimiento CREATE_SHARE_LINK_VIEW.
Procedimiento DROP_SHARE_VERSION Borre una única versión de recurso compartido.
Procedimiento DROP_SHARE_VERSIONS Borre un rango de versiones de recursos compartidos.
Procedimiento DROP_UNUSED_SHARE_VERSIONS Borre cualquier versión de recurso compartido que no esté en uso actualmente.
Procedimiento ENABLE_SCHEMA Activar o desactivar un esquema para compartir.
Función GET_ACTIVATION_LINK Genere el enlace que se incluirá en los correos electrónicos al destinatario autorizado.
Función GET_PUBLISHED_IDENTITY Obtenga datos sobre el usuario actual definido por SET_PUBLISHED_IDENTITY.
Función GET_RECIPIENT_PROPERTY Devolver el valor de una propiedad para un destinatario.
Función GET_SHARE_PROPERTY Obtener el valor de propiedad de un recurso compartido existente.
Función GET_SHARE_TABLE_PROPERTY Obtener el valor de propiedad de una tabla de recursos compartidos existente.
Procedimiento GRANT_TO_RECIPIENT Otorgar acceso en un recurso compartido a un destinatario específico.
Procedimiento POPULATE_SHARE_PROFILE Generación de un perfil delta para un destinatario.
Procedimiento PUBLISH_SHARE Publicar un recurso compartido y volver inmediatamente.
Procedimiento PUBLISH_SHARE_WAIT Publique un recurso compartido y espere hasta que se complete el trabajo en segundo plano.
Procedimiento PURGE_DETACHED_FILES Suprima u olvide los archivos de parquet que se han desasociado de sus recursos compartidos.
Procedimiento REMOVE_FROM_SHARE Elimine una tabla o una vista de un recurso compartido.
Procedimiento RENAME_RECIPIENT Cambiar el nombre de un destinatario.
Procedimiento RENAME_SHARE Cambie el nombre de un recurso compartido.
Procedimiento RENAME_SHARE_LINK Cambie el nombre de un enlace de recurso compartido registrado.
Procedimiento RENAME_SHARE_SCHEMA Cambie el nombre de un esquema de recurso compartido.
Procedimiento RENAME_SHARE_TABLE Cambie el nombre de una tabla de recursos compartidos.
Procedimiento REVOKE_FROM_RECIPIENT Revocar el acceso a un recurso compartido de un destinatario específico.
Procedimiento SET_CURRENT_SHARE_VERSION Cambiar la versión actual de un recurso compartido.
Procedimiento SET_PUBLISHED_IDENTITY Defina los datos sobre el usuario actual que se proporcionarán a los destinatarios de los recursos compartidos de ORACLE publicados.
Procedimiento SET_RECIPIENT_LOG_LEVEL Cambie el nivel de log de un destinatario de recurso compartido existente.
Procedimiento SET_SHARE_LOG_LEVEL Cambiar el nivel de log de un recurso compartido existente.
Procedimiento SET_STORAGE_CREDENTIAL Defina el nombre de la credencial de acceso para el almacenamiento proporcionado.
Procedimiento STOP_JOB Parar un trabajo de recurso compartido en ejecución.
Procedimiento UNPUBLISH_SHARE Anule la publicación de un recurso compartido.
Procedimiento UPDATE_DEFAULT_RECIPIENT_PROPERTY Actualice los valores de propiedad de destinatario por defecto.
Procedimiento UPDATE_DEFAULT_SHARE_PROPERTY Actualice los valores predeterminados de la propiedad de recurso compartido.
Procedimiento UPDATE_RECIPIENT_PROPERTY Actualizar una propiedad de un destinatario existente.
Procedimiento UPDATE_SHARE_JOB_PROPERTY Modificar propiedades de un trabajo de recurso compartido en ejecución.
Procedimiento UPDATE_SHARE_PROPERTY Actualizar una propiedad de un recurso compartido existente.
Procedimiento UPDATE_SHARE_TABLE_PROPERTY Actualice el valor de propiedad de una tabla de recursos compartidos existente.
Función VALIDATE_CREDENTIAL Valide un nombre de credencial y, si es necesario, conviértalo en formato canónico.
Procedimiento VALIDATE_SHARE_STORAGE Compruebe si el almacenamiento determinado es adecuado para recursos compartidos versionados.
Procedimiento WAIT_FOR_JOB Este procedimiento espera hasta que se complete el trabajo de recursos compartidos especificado.

Tema principal: Paquete DBMS_SHARE

Procedimiento ADD_TO_SHARE

Agregue una tabla o vista a un recurso compartido. El objeto se vuelve visible para cualquier usuario externo al que se le haya otorgado acceso al recurso compartido.

Sintaxis

PROCEDURE ADD_TO_SHARE  
(
    share_name           IN VARCHAR2,
    table_name           IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    share_table_name     IN VARCHAR2 := NULL,
    share_schema_name    IN VARCHAR2 := NULL,
    object_metadata      IN SYS.JSON_OBJECT_T := NULL,
    replace_existing     IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre de un recurso compartido existente al que se otorga el objeto.
table_name Nombre de la entidad que se va a compartir (por ejemplo, un nombre de tabla o vista).
owner Propietario de la entidad que se va a compartir. El valor por defecto es el esquema actual.
share_table_name Nombre visible externamente de la tabla. Por defecto, es el table_name en mayúscula.
share_schema_name Esquema visible externamente donde se colocará la tabla. Por defecto, este es el propietario de la tabla en mayúsculas. El esquema se crea automáticamente si aún no existe.
object_metadata Metadatos opcionales para asociar con la entidad compartida.
replace_existing Si es TRUE, y este share_table_name ya existe, el table_name existente se borra del recurso compartido y se sustituye por este table_name.

Si FALSE y este share_table_name ya existe, se emite una excepción que indica que la tabla de recursos compartidos ya está en uso.

share_owner Propietario de la acción.
auto_commit Si es TRUE, esta llamada de procedimiento confirma los cambios que no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es FALSE, lo que significa que el usuario debe COMMIT después de ejecutar esta llamada para que el cambio sea visible.

Procedimiento ASSERT_SHAREABLE_OBJECT

Devolver sin errores, si el objeto existe y se puede compartir.

Sintaxis

PROCEDURE ASSERT_SHAREABLE_OBJECT
(
  object_name          IN VARCHAR2,
  object_owner         IN VARCHAR2 := NULL
);

Parámetros

parámetro Descripción
object_name Nombre del objeto.
object_owner Propietario del objeto. Se define por defecto en el esquema actual.

Procedimiento ASSERT_SHARING_ID

Ejecute comprobaciones de validación básicas en un ID de uso compartido y devuelva una en formato canónico. Se emite una excepción si el ID obviamente no es válido.

Sintaxis

PROCEDURE ASSERT_SHARING_ID  
(
    sharing_id              IN OUT NOCOPY VARCHAR2,
    out_sharing_id_type     IN OUT NOCOPY VARCHAR2  
);

Parámetros

parámetro Descripción
sharing_id El ID que se va a comprobar.
out_sharing_id_type Tipo de ID, si es válido. Por ejemplo, TENANCY o DATABASE.

Función CAN_CREATE_SHARE

Esta función comprueba si el esquema actual puede crear destinatarios de recursos compartidos. Si se pueden crear recursos compartidos, se devuelve un 1 y otro 0.

Sintaxis

FUNCTION CAN_CREATE_SHARE
RETURN NUMBER;

Ejemplo: antes y después de activar el esquema de administración

SQL> select dbms_share.can_create_share from dual;
 CAN_CREATE_SHARE
----------------
               0 
SQL> exec dbms_share.enable_schema('admin') 
PL/SQL procedure successfully completed. 
SQL> select dbms_share.can_create_share from dual; 
CAN_CREATE_SHARE
----------------
               1

Función CAN_CREATE_SHARE_RECIPIENT

Esta función comprueba si el esquema actual puede crear destinatarios de recursos compartidos. Si se pueden crear recursos compartidos, se devuelve un 1 y otro 0.

Sintaxis

FUNCTION CAN_CREATE_SHARE_RECIPIENT
RETURN NUMBER;

Procedimiento CLEAR_RECIPIENT_EVENTS

Borre los eventos del registro de eventos del destinatario compartido.

Sintaxis

PROCEDURE CLEAR_RECIPIENT_EVENTS 
(
   recipient_name       IN VARCHAR2,
   from_time            IN TIMESTAMP WITH TIME ZONE := NULL,
   to_time              IN TIMESTAMP WITH TIME ZONE := NULL,
   recipient_owner      IN VARCHAR2 := NULL 
);

Parámetros

parámetro Descripción
recipient_name Nombre local del destinatario del recurso compartido.
from_time Primera hora para eventos que se deben borrar o NULL.
to_time Última hora para eventos que se deben borrar o NULL.
recipient_owner Esquema propietario del destinatario.

Procedimiento CLEAR_SHARE_EVENTS

Borre los eventos del log de eventos compartidos.

Sintaxis

PROCEDURE CLEAR_SHARE_EVENTS 
(
    share_name           IN VARCHAR2,
    from_time            IN TIMESTAMP WITH TIME ZONE := NULL,
    to_time              IN TIMESTAMP WITH TIME ZONE := NULL,
    share_owner          IN VARCHAR2 := NULL 
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
from_time Primera hora para eventos que se deben borrar o NULL.
to_time Última hora para eventos que se deben borrar o NULL.
share_owner Esquema propietario del recurso compartido.

Procedimiento CREATE_BEARER_TOKEN_CREDENTIAL

Cree una credencial adecuada para su uso con proveedores de recursos compartidos delta.

Esto es similar a la llamada CREATE_CREDENTIALS, pero toma valores explícitos en lugar de un perfil de uso compartido delta. Consulte CREATE_CREDENTIALS Procedimiento y función para obtener más información.

Sintaxis

PROCEDURE CREATE_BEARER_TOKEN_CREDENTIAL 
(
   credential_name      IN VARCHAR2,
   bearer_token         IN VARCHAR2 := NULL,
   token_endpoint       IN VARCHAR2 := NULL,
   client_id            IN VARCHAR2 := NULL,
   client_secret        IN VARCHAR2 := NULL,
   token_refresh_rate   IN PLS_INTEGER := 3600 
);

Parámetros

parámetro Descripción
credential_name Nombre de la nueva credencial.
bearer_token El token de portador, si se conoce.
token_endpoint Punto final al que llamar para obtener un nuevo token.
client_id Nombre de usuario que se enviará a token_endpoint.
client_secret Contraseña que se enviará a token_endpoint.
token_refresh_rate Tiempo de refrescamiento opcional, en segundos.

Ejemplo: Credencial con un token de portador fijo

En su forma más sencilla, este procedimiento equivale a llamar a DBMS_CREDENTIAL con un nombre de usuario 'BEARER_TOKEN' y el token de portador en sí como contraseña. 

SQL> exec dbms_share.create_bearer_token_credential('MY_FIXED_CREDENTIAL', 'FF42322D27D4C2DEE05392644664351E')
PL/SQL procedure successfully completed. 
SQL> select username from user_credentials where credential_name = 'MY_FIXED_CREDENTIAL';
USERNAME
------------------------------------------------------------------------------------------------------------------------
BEARER_TOKEN

Ejemplo: Credencial con un token de portador renovable

Cree una credencial que contenga un token de portador de corta duración obtenido de un punto final de token. El token de portador se refrescará una vez cada hora mediante una segunda credencial, que se rellena a partir del ID de cliente y el secreto.

SQL> BEGIN
  2    dbms_share.create_bearer_token_credential(
  3      credential_name=>'MY_RENEWABLE_CREDENTIAL',
  4      token_endpoint=>'https://myserver/ords/share_provider/oauth/token',
  5      client_id=>'VXGQ_44s6qJ-K4WHUNM2yQ..',
  6      client_secret=>'y9ddppgwEmZl7adDHFQndw..');
  7  END;
  8  /
 PL/SQL procedure successfully completed.
 SQL> select credential_name, username from user_credentials where credential_name LIKE 'MY_RENEWABLE_CREDENTIAL%';
 CREDENTIAL_NAME                              USERNAME
------------------------------------------    -------------------------------------
MY_RENEWABLE_CREDENTIAL                       BEARER_TOKEN
MY_RENEWABLE_CREDENTIAL$TOKEN_REFRESH_CRED    VXGQ_44s6qJ-K4WHUNM2yQ..

Procedimiento CREATE_CLOUD_STORAGE_LINK

Cree un enlace URI de almacenamiento en la nube con nombre. Un enlace de almacenamiento en la nube es una asociación con nombre entre un URI de cubo de OCI y un nombre de credencial local.

Nota

Utilice el procedimiento SET_STORAGE_CREDENTIAL para agregar una credencial al enlace de almacenamiento.

Sintaxis

PROCEDURE CREATE_CLOUD_STORAGE_LINK
(
  storage_link_name    IN VARCHAR2,
  uri                  IN VARCHAR2,
  owner                IN VARCHAR2 := NULL,
  metadata             IN SYS.JSON_OBJECT_T := NULL,
  auto_commit          IN BOOLEAN := TRUE
);

Parámetros

parámetro Descripción
storage_link_name Nombre del enlace de almacenamiento en la nube. El nombre del enlace debe seguir las convenciones de nomenclatura estándar de Oracle.
uri El URI del cubo de almacenamiento. El URI debe tener el formato https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner El propietario del enlace de almacenamiento. Deje NULL para el usuario actual.
metadata (Opcional) Documento de metadatos JSON que contiene información adicional.
auto_commit El valor por defecto es TRUE. Si es TRUE, esta transacción se confirma. Si es FALSE, el usuario debe confirmar la transacción. Los cambios no son visibles hasta que se realiza la confirmación.

Ejemplo

En este ejemplo, se crea un enlace de almacenamiento en la nube denominado MY_SHARE_STORAGE en la URL proporcionada. 

SQL> BEGIN
  2    dbms_share.create_cloud_storage_link(
  3      'MY_SHARE_STORAGE',
  4      'https://objectstorage.../n/abcdef/b/my_bucket/o' );
  5  END;
  6  /

PL/SQL procedure successfully completed.

SQL> select storage_link_name from user_lineage_cloud_storage_links;

STORAGE_LINK_NAME
----------------------------------------------------------------------------------------
MY_SHARE_STORAGE

Procedimiento CREATE_OR_REPLACE_CLOUD_STORAGE_LINK

Cree o sustituya un URI de almacenamiento en la nube con nombre. Un enlace de almacenamiento en la nube es una asociación con nombre entre un URI de cubo de OCI y un nombre de credencial local.

Nota

Utilice el procedimiento SET_STORAGE_CREDENTIAL para agregar una credencial al enlace de almacenamiento.

Sintaxis

PROCEDURE CREATE_OR_REPLACE_CLOUD_STORAGE_LINK  
(
    storage_link_name    IN VARCHAR2,
    uri                  IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    metadata             IN SYS.JSON_OBJECT_T := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
storage_link_name Nombre del enlace de almacenamiento en la nube. El nombre del enlace debe seguir las convenciones de nomenclatura estándar de Oracle. Consulte Nombres y cualificadores de objeto de base de datos
uri El URI del cubo de almacenamiento. El URI debe tener el formato https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner El propietario del enlace de almacenamiento. Se define por defecto en el esquema actual.
metadata Documento de metadatos JSON opcional que contiene información adicional.
auto_commit Si es TRUE, los cambios se confirman automáticamente después de crear el enlace. El valor por defecto es TRUE.

Procedimiento CREATE_OR_REPLACE_SHARE_RECIPIENT

Cree o sustituya un destinatario compartido. Debe proporcionar al menos una dirección de correo electrónico o un ID de uso compartido.

Sintaxis

PROCEDURE CREATE_OR_REPLACE_SHARE_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    description          IN VARCHAR2 := NULL,
    recipient_owner      IN VARCHAR2 := NULL,
    email                IN VARCHAR2 := NULL,
    sharing_id           IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
recipient_name Nombre local del destinatario del recurso compartido. Algunos nombres no están permitidos (por ejemplo, MY_TENANCY).
description Descripción del destinatario.
recipient_owner Esquema propietario del destinatario.
email Un correo electrónico que se registrará para el usuario de OAUTH.
sharing_id ID de uso compartido del destinatario, de la función GET_SHARING_ID.

Procedimiento CREATE_SHARE

Cree un objeto compartido con nombre.

Sintaxis

PROCEDURE CREATE_SHARE
(
  share_name           IN VARCHAR2,
  share_type           IN VARCHAR2 := SHARE_TYPE_VERSIONED,
  storage_link_name    IN VARCHAR2 := NULL,
  storage_link_owner   IN VARCHAR2 := NULL,
  description          IN VARCHAR2 := NULL,
  public_description   IN VARCHAR2 := NULL,
  configuration        IN SYS.JSON_OBJECT_T := NULL,
  force_create         IN BOOLEAN  := FALSE,
  share_owner          IN VARCHAR2 := NULL,
  auto_commit          IN BOOLEAN := FALSE,
  log_level            IN PLS_INTEGER := LOG_LEVEL_BASIC,
  run_storage_tests    IN BOOLEAN := TRUE
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido. Este nombre está en mayúsculas, ya que los recursos compartidos delta no distinguen entre mayúsculas y minúsculas. El nombre sigue las convenciones estándar de Oracle, por lo que debe tener 128 caracteres o menos y debe estar entre comillas dobles si no es un identificador simple. La única diferencia es que será superior incluso si se cita dos veces.
share_type El tipo de recurso compartido. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Tipos de recursos compartidos en DBMS_SHARE Constants.
storage_link_name Nombre del enlace de almacenamiento en la nube en el que se crean los objetos. El usuario debe tener acceso de lectura/escritura a este almacenamiento y tener la capacidad de crear solicitudes autenticadas previamente en el almacenamiento. El parámetro es necesario para los recursos compartidos versionados y opcional para los recursos compartidos actuales.
storage_link_owner Propietario del enlace de almacenamiento en la nube donde se crean los objetos.
description Descripción local del recurso compartido.
public_description Descripción pública del recurso compartido.
configuration Documento de configuración que define cómo se crean los objetos.
force_create Defina force_create en TRUE para redefinir el recurso compartido si existe.
share_owner Propietario de la acción.
auto_commit Si es TRUE, esta llamada de procedimiento confirma los cambios que no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es FALSE, lo que significa que el usuario debe COMMIT después de ejecutar esta llamada para que el cambio sea visible.
log_level Nivel de registro de eventos. Esto controla la cantidad de detalles registrados en la Vista ALL_SHARE_EVENTS. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Nivel de log en DBMS_SHARE Constants.
run_storage_tests Si este parámetro es TRUE, DBMS_SHARE ejecuta pruebas para verificar que el enlace de almacenamiento de recursos compartidos especificado tenga los privilegios correctos.

Si este parámetro es FALSE, el procedimiento no ejecuta ninguna comprobación en el momento de la creación. Esto puede llevar a errores más adelante, durante la publicación o el consumo de la acción.

Oracle recomienda especificar TRUE para este parámetro.

Procedimiento CREATE_SHARE_RECIPIENT

Cree un nuevo destinatario de recursos compartidos.

Sintaxis

PROCEDURE CREATE_SHARE_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    description          IN VARCHAR2 := NULL,
    recipient_owner      IN VARCHAR2 := NULL,
    email                IN VARCHAR2 := NULL,
    sharing_id           IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
recipient_name Nombre local del destinatario del recurso compartido. Algunos nombres no están permitidos, por ejemplo: MY_TENANCY.
description Descripción del destinatario.
recipient_owner Esquema propietario del destinatario.
email Un correo electrónico que se registrará para el usuario de OAUTH. Debes proporcionar al menos un ID de correo electrónico o de uso compartido.
sharing_id ID de uso compartido del destinatario de la función GET_SHARING_ID. Debes proporcionar al menos un ID de correo electrónico o de uso compartido.

Procedimiento DROP_CLOUD_STORAGE_LINK

Borre un enlace de almacenamiento en la nube.

Sintaxis

PROCEDURE DROP_CLOUD_STORAGE_LINK  
(
    storage_link_name    IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
storage_link_name Nombre del enlace de almacenamiento en la nube que se va a borrar.
owner El propietario del enlace de almacenamiento en la nube. Deje NULL para el usuario actual.
auto_commit Si es TRUE, el código se confirma automáticamente después de borrar el enlace. El valor por defecto es TRUE.

Procedimiento DROP_RECIPIENT

Borrar un destinatario. Se revocará todo el acceso al destinatario.

Sintaxis

PROCEDURE DROP_RECIPIENT  
(
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
recipient_name Nombre del destinatario del recurso compartido.
owner Esquema que define el destinatario.

Procedimiento DROP_SHARE

Soltar un recurso compartido y todo su contenido. El acceso futuro a la participación de los consumidores terminará.

Sintaxis

PROCEDURE DROP_SHARE
(
  share_name           IN VARCHAR2,
  share_owner          IN VARCHAR2 := NULL,
  destroy_objects      IN BOOLEAN := TRUE
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido que se va a borrar.
share_owner Propietario del recurso compartido que se va a eliminar.
destroy_objects Si es TRUE, suprima todos los objetos creados en nombre del recurso compartido. El valor por defecto es TRUE.

Procedimiento DROP_SHARE_LINK_VIEW

Borre una vista creada mediante el procedimiento CREATE_SHARE_LINK_VIEW.

Consulte Procedimiento CREATE_SHARE_LINK_VIEW para obtener más información.

Sintaxis

PROCEDURE DROP_SHARE_LINK_VIEW  
(
    view_name            IN VARCHAR2,
    view_owner           IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
view_name El nombre de la nueva vista.
view_owner Propietario de la vista. El valor por defecto es el esquema actual.

Procedimiento DROP_SHARE_VERSION

Borre una única versión de recurso compartido. Tenga en cuenta que no puede borrar la versión actual.

Sintaxis

PROCEDURE DROP_SHARE_VERSION  
(
    share_name           IN VARCHAR2,
    share_version        IN NUMBER,
    destroy_objects      IN BOOLEAN := TRUE,
    force_drop           IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_version Versión que se va a borrar. No puede borrar la versión actual.
destroy_objects Destruya cualquier objeto asociado en el almacenamiento en la nube, si corresponde.
force_drop Borre la versión del recurso compartido incluso si hay un archivo PAR pendiente en la versión.
share_owner Propietario de la acción.

Procedimiento DROP_SHARE_VERSIONS

Borre un rango de versiones de recursos compartidos. Tenga en cuenta que no puede borrar la versión actual mediante este procedimiento.

Sintaxis

PROCEDURE DROP_SHARE_VERSIONS  
(
    share_name           IN VARCHAR2,
    from_share_version   IN NUMBER,
    to_share_version     IN NUMBER,
    destroy_objects      IN BOOLEAN := TRUE,
    force_drop           IN BOOLEAN := FALSE,
    share_owner          IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
from_share_version Versión más baja para borrar.
to_share_version La versión más alta para borrar.
destroy_objects Destruya cualquier objeto asociado en el almacenamiento en la nube, si corresponde.
force_drop Borre la versión del recurso compartido incluso si hay un archivo PAR pendiente en la versión.
share_owner Propietario de la acción.

Procedimiento DROP_UNUSED_SHARE_VERSIONS

Borre cualquier versión de recurso compartido que no esté en uso actualmente.

Sintaxis

PROCEDURE DROP_UNUSED_SHARE_VERSIONS  
(
    share_name           IN VARCHAR2,
    destroy_objects      IN BOOLEAN := TRUE,
    share_owner          IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
destroy_objects Destruya cualquier objeto asociado en el almacenamiento en la nube, si corresponde.
share_owner Propietario de la acción.

Procedimiento ENABLE_SCHEMA

Activar o desactivar un esquema para compartir. El usuario ADMIN debe ejecutar este procedimiento.

Sintaxis

Los usuarios pueden consumir recursos compartidos delta sin estar activados con este procedimiento, pero no pueden crear ni publicar recursos compartidos. El uso compartido está desactivado por defecto para todos los esquemas, incluido ADMIN.

PROCEDURE ENABLE_SCHEMA  
(
    schema_name          IN VARCHAR2,
    enabled              IN BOOLEAN := TRUE,
    privileges           IN PLS_INTEGER := NULL
);

Parámetros

parámetro Descripción
schema_name Esquema que se va a activar o desactivar.
enable VERDADERO para activar, FALSO para desactivar.
privileges El argumento de privilegios tiene valores de bitmap. Si deja el argumento como NULL, el valor por defecto es PRIV_CREATE_SHARE + PRIV_CREATE_RECIPIENT + PRIV_CONSUME_ORACLE_SHARE.

Los valores de bitmap son los siguientes:
  • PRIV_CREATE_SHARE
    Permitir a los usuarios crear recursos compartidos de publicación en su propio esquema.
    PRIV_CREATE_SHARE         CONSTANT PLS_INTEGER := 1;
  • PRIV_CREATE_RECIPIENT

    Permitir a los usuarios crear destinatarios de recursos compartidos en su propio esquema.

    PRIV_CREATE_RECIPIENT     CONSTANT PLS_INTEGER := 2;
  • PRIV_CONSUME_ORACLE_SHARE

    Permitir a los usuarios consumir recursos compartidos activos de Oracle a Oracle.

    PRIV_CONSUME_ORACLE_SHARE CONSTANT PLS_INTEGER := 4;
  • PRIV_ORDS_ACL

    Otorgue una ACL al usuario en el punto final de ORDS local. Esto es necesario para que el usuario genere tokens de portador en recursos compartidos creados localmente.

    PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Función GET_ACTIVATION_LINK

Genere el enlace que se incluirá en los correos electrónicos al destinatario autorizado. Este enlace de activación conduce a la página de descarga, donde el destinatario hace clic en un botón para obtener el perfil delta.

Sintaxis

FUNCTION GET_ACTIVATION_LINK
(
  recipient_name       IN VARCHAR2,
  recipient_owner      IN VARCHAR2 := NULL,
  expiration           IN PLS_INTEGER := 259200,
  invalidate_previous  IN BOOLEAN := TRUE
)
RETURN VARCHAR2;

Parámetros

parámetro Descripción
recipient_name Nombre local del destinatario.
recipient_owner Esquema propietario del destinatario.
expiration Número de segundos antes de que caduque el enlace de activación.
invalidate_previous Si es TRUE, que es el valor predeterminado, un enlace de activación generado anteriormente se convierte en no válido. Si es FALSE, un enlace de activación generado previamente sigue siendo válido.

Ejemplo: impresión del enlace de activación a la pantalla

SQL> exec dbms_share.create_share_recipient('new_recipient', email=>'anyone@example.com')

PL/SQL procedure successfully completed.

SQL> column PROFILE format A200
SQL> variable sprof varchar2(32767)
SQL> declare
  2    profile sys.json_object_t;
  3  begin
  4    dbms_share.populate_share_profile('NEW_RECIPIENT', profile);
  5    :sprof := profile.to_string;
  6  end;
  7  /
PL/SQL procedure successfully completed.

SQL> exec dbms_output.put_line(dbms_share.get_activation_link('NEW_RECIPIENT'))
http://.../ords/_adpshr/delta-sharing/download?key=43BA....YXJlX3Rlc3Q= 

PL/SQL procedure successfully completed.

Función GET_PUBLISHED_IDENTITY

Obtenga datos sobre el usuario actual definido por SET_PUBLISHED_IDENTITY.

Sintaxis

FUNCTION GET_PUBLISHED_IDENTITY
  RETURN CLOB;

Ejemplo

SQL> declare
  2    id_json json_object_t := json_object_t();
  3  begin
  4    id_json.put('name', 'Demo Publisher');
  5    id_json.put('description', 'Documentation Share Provider');
  6    id_json.put('contact', 'null@example.com');
  7    dbms_share.set_published_identity(id_json);
  8  end;
  9  /

PL/SQL procedure successfully completed.

SQL> select json_query(dbms_share.get_published_identity, '$' pretty) "Published Identity"
  2  from dual;

Published Identity-
-------------------------------------------------------------------------------
{
  "name" : "Demo Publisher",
  "description" : "Documentation Share Provider",
  "contact" : "null@example.com"
}

Función GET_RECIPIENT_PROPERTY

Devolver el valor de una propiedad para un destinatario.

Sintaxis

FUNCTION GET_RECIPIENT_PROPERTY
(
  recipient_name       IN VARCHAR2,
  recipient_property   IN VARCHAR2,
  recipient_owner      IN VARCHAR2 := NULL
)RETURN VARCHAR2;

Parámetros

parámetro Descripción
recipient_name Nombre del destinatario.
recipient_property Propiedad que se debe obtener. En estas propiedades se incluye:
  • PROP_SHARE_DESC
  • PROP_SHARE_PUBLIC_DESC
  • PROP_SHARE_VERSION_ACCESS
  • PROP_SHARE_JOB_NAME
  • PROP_SHARE_SPLIT_SIZE
  • PROP_SHARE_LOG_LEVEL
  • PROP_SHARE_JOB_DOP
  • PROP_SHARE_JOB_CLASS
  • PROP_SHARE_JOB_PRIORITY
  • PROP_SHARE_VERSION_ACCESS

Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Propiedades de recurso compartido en DBMS_SHARE Constants.

recipient_owner Propietario del destinatario. El valor por defecto es el usuario actual.

Función GET_SHARE_PROPERTY

Obtener el valor de propiedad de un recurso compartido existente.

Sintaxis

FUNCTION GET_SHARE_PROPERTY
(
  share_name       IN VARCHAR2,
  share_property   IN VARCHAR2,
  share_owner      IN VARCHAR2 := NULL
)
RETURN VARCHAR2

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_property Valor de la propiedad que se va a obtener. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Propiedades de recurso compartido en DBMS_SHARE Constants.
share_owner Propietario de la acción. El valor por defecto es el usuario actual.

Función GET_SHARE_TABLE_PROPERTY

Obtener el valor de propiedad de una tabla de recursos compartidos existente.

Sintaxis

FUNCTION GET_SHARE_TABLE_PROPERTY
(
  share_name           IN VARCHAR2,
  share_table_name     IN VARCHAR2,
  share_table_property IN VARCHAR2,
  share_schema_name    IN VARCHAR2 := NULL,
  share_owner          IN VARCHAR2 := NULL
)RETURN VARCHAR2;

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_table_name El nombre de la tabla de recursos compartidos.
share_table_property Propiedad de la tabla de recursos compartidos que se actualizará. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Compartir propiedades de tabla en DBMS_SHARE Constants.
share_schema_name Nombre del esquema de recurso compartido. El valor predeterminado es mayúscula del usuario actual.
share_owner Propietario de la acción.

Procedimiento GRANT_TO_RECIPIENT

Otorgar acceso en un recurso compartido a un destinatario específico. El recurso compartido y el destinatario deben pertenecer al mismo esquema.

Sintaxis

PROCEDURE GRANT_TO_RECIPIENT  
(
    share_name           IN VARCHAR2,
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name Nombre del recurso compartido que se va a otorgar.
recipient_name Nombre del destinatario.
owner El propietario del recurso compartido y el destinatario.
auto_commit Se ignora el parámetro auto_commit. Este procedimiento siempre se confirmará.

Procedimiento POPULATE_SHARE_PROFILE

Generación de un perfil delta para un destinatario. Puede imprimirlo en la pantalla o cargarlo en algún lugar. Por ejemplo, para un cubo de objeto mediante DBMS_CLOUD.EXPORT_DATA.

Sintaxis

PROCEDURE POPULATE_SHARE_PROFILE  
(
    recipient_name       IN VARCHAR2,
    share_profile        IN OUT NOCOPY SYS.JSON_OBJECT_T,
    recipient_owner      IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
recipient_name Nombre local del destinatario.
share_profile El perfil de recurso compartido, sin token de portador.
recipient_owner Esquema propietario del destinatario.

Ejemplo: imprima el perfil en la pantalla.

SQL> EXEC DBMS_SHARE.CREATE_SHARE_RECIPIENT('new_recipient', email=>'anyone@example.com')
 
PL/SQL procedure successfully completed. 
SQL> column PROFILE format A200
SQL> variable sprof varchar2(32767)
SQL> declare
  2    profile sys.json_object_t;
  3  begin
  4    dbms_share.populate_share_profile('NEW_RECIPIENT', profile);
  5    :sprof := profile.to_string;
  6  end;
  7  /

PL/SQL procedure successfully completed. 

SQL> select json_query(:sprof, '$' pretty) "PROFILE" from dual;
PROFILE------------------------------------------------------------------------------------------------------------------------
{
  "shareCredentialsVersion" : 1,
  "endpoint" : "https://.../ords/share_test/_delta_sharing/",
  "bearerToken" : "mc7puvhqCpU6xjTOjRdl_w",
  "tokenEndpoint" : "https://.../ords/share_test/oauth/token",
  "clientID" : "VXGQ_44s6qJ-K4WHUNM2yQ..",
  "clientSecret" : "y9ddppgwEmZl7adDHFQndw.."
}

Procedimiento PUBLISH_SHARE

Publicar un recurso compartido y volver inmediatamente.

La publicación continuará en segundo plano. Puede comprobar el estado del trabajo consultando la vista USER_SHARE_JOBS. Consulte USER_SHARE_JOBS View para obtener más información.

Sintaxis

PROCEDURE PUBLISH_SHARE  
(
    share_name           IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    drop_prior_versions  IN BOOLEAN := FALSE,
    share_job_dop        IN NUMBER := NULL,
    share_job_priority   IN NUMBER := NULL,
    job_class            IN VARCHAR2 := 'DEFAULT_JOB_CLASS',
    force_job_class      IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido que se va a publicar.
share_owner Propietario del recurso compartido, que debe ser el usuario actual o NULL.
drop_prior_versions Establézcalo en TRUE si desea borrar todas las versiones anteriores del recurso compartido. Tenga en cuenta que las versiones solo se borran si no hay solicitudes autenticadas previamente (PAR) pendientes.
share_job_dop Especifique el número máximo de trabajos dbms_scheduler que se utilizarán para publicar el recurso compartido. Deje el valor NULL para utilizar el número por defecto del sistema.
share_job_priority Especifique una prioridad relativa de esta publicación de recurso compartido en comparación con otras. Si se publican dos recursos compartidos al mismo tiempo, el que tiene la prioridad más alta se procesa primero, incluso si se inició más tarde.
job_class Clase de trabajo del programador, de all_scheduler_job_classes, que se utiliza para publicar el recurso compartido.
force_job_class Utilice el valor job_class especificado incluso si el administrador ha definido una clase de trabajo por defecto diferente.

Procedimiento PUBLISH_SHARE_WAIT

Publique un recurso compartido y espere hasta que se complete el trabajo en segundo plano. La publicación continúa aunque se interrumpa la llamada.

Sintaxis

PROCEDURE PUBLISH_SHARE_WAIT  
(
       share_name           IN VARCHAR2,
       share_owner          IN VARCHAR2 := NULL,
       drop_prior_versions  IN BOOLEAN := FALSE,
       share_job_dop        IN NUMBER := NULL,
       share_job_priority   IN NUMBER := NULL,
       job_class            IN VARCHAR2 := 'DEFAULT_JOB_CLASS',
       force_job_class      IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido que se va a publicar.
share_owner Propietario del recurso compartido, que debe ser el usuario actual o NULL.
drop_prior_versions Establézcalo en TRUE si desea borrar todas las versiones anteriores del recurso compartido. Tenga en cuenta que las versiones solo se borran si no hay solicitudes autenticadas previamente (PAR) pendientes.
share_job_dop Especifique el número máximo de trabajos dbms_scheduler que se utilizarán para publicar el recurso compartido. Deje el valor NULL para utilizar el número por defecto del sistema.
share_job_priority Especifique una prioridad relativa de esta publicación de recurso compartido en comparación con otras. Si se publican dos recursos compartidos al mismo tiempo, el que tiene la prioridad más alta se procesa primero, incluso si se inició más tarde.
job_class Clase de trabajo del programador, de all_scheduler_job_classes, que se utiliza para publicar el recurso compartido.
force_job_class Utilice el valor job_class especificado incluso si el administrador ha definido una clase de trabajo por defecto diferente.

Procedimiento PURGE_DETACHED_FILES

Suprima u olvide los archivos de parquet que se han desasociado de sus recursos compartidos.

Sintaxis

PROCEDURE PURGE_DETACHED_FILES  
(
    file_pattern         IN VARCHAR2 := '%',
    credential_name      IN VARCHAR2 := NULL,
    purge_mode           IN PLS_INTEGER := PURGE_DROP,
    owner_id             IN NUMBER := SYS_CONTEXT('USERENV', 'CURRENT_USERID')  
);

Versión de PURGE_DETACHED_FILES que devuelve el ID del trabajo de depuración, si lo hay. 

PROCEDURE PURGE_DETACHED_FILES  
(
    purge_job_id         IN OUT NOCOPY NUMBER,
    file_pattern         IN VARCHAR2 := '%',
    credential_name      IN VARCHAR2 := NULL,
    purge_mode           IN PLS_INTEGER := PURGE_DROP,
    owner_id             IN NUMBER := SYS_CONTEXT('USERENV', 'CURRENT_USERID')  
);

Parámetros

parámetro Descripción
purge_job_id ID de trabajo de depuración.
file_pattern Un patrón LIKE opcional para los archivos que se van a depurar.
credential_name Credencial opcional que se utilizará para suprimir los archivos.
purge_mode Especifica cómo se depuran los archivos. Los valores del modo de depuración incluyen:
  • PURGE_DROP
    Intente borrar los archivos con la credencial especificada. Si el archivo no se puede borrar, el archivo seguirá apareciendo en las vistas *_SHARE_DETACHED_FILES.
    PURGE_DROP             CONSTANT PLS_INTEGER := 1;
  • PURGE_DROP_FORCE
    Intente borrar los archivos con la credencial especificada. El archivo se eliminará de las vistas *_SHARE_DETACHED_FILES incluso si el intento de borrar el archivo falla de nuevo.
    PURGE_DROP_FORCE       CONSTANT PLS_INTEGER := 2;
  • PURGE_FORGET
    Elimine las vistas *_SHARE_DETACHED_FILES de los archivos sin intentar borrarlas.
    PURGE_FORGET           CONSTANT PLS_INTEGER := 3;
owner_id ID de propietario cuyos archivos se van a depurar.

Procedimiento REMOVE_FROM_SHARE

Elimine una tabla o una vista de un recurso compartido.

Sintaxis

PROCEDURE REMOVE_FROM_SHARE  
(
    share_name           IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_schema_name    IN VARCHAR2 := NULL,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre de un recurso compartido existente al que se revoca el objeto.
share_table_name Nombre de la tabla de recursos compartidos que se va a revocar. Debe coincidir con el nombre visible externamente, por lo que la entrada estará en mayúsculas.
share_schema_name Nombre del esquema de recurso compartido. El valor predeterminado es mayúscula del usuario actual.
share_owner Propietario de la acción.
auto_commit Si es TRUE, esta llamada de procedimiento confirma los cambios que no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es FALSE, lo que significa que el usuario debe COMMIT después de ejecutar esta llamada para que el cambio sea visible.

Procedimiento RENAME_RECIPIENT

Cambiar el nombre de un destinatario. Este procedimiento solo cambia el nombre local del destinatario. La definición externa del destinatario, por ejemplo, el nombre del usuario de OAUTH o el ID de uso compartido, no se cambia.

Sintaxis

PROCEDURE RENAME_RECIPIENT  
(
    old_recipient_name   IN VARCHAR2,
    new_recipient_name   IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
old_recipient_name Nombre actual del destinatario del recurso compartido.
new_recipient_name El nuevo nombre del destinatario del recurso compartido.
owner Esquema que define el destinatario.
auto_commit Si es TRUE, los cambios se confirman automáticamente. Los cambios no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es TRUE.

Procedimiento RENAME_SHARE

Cambie el nombre de un recurso compartido. Se debe tener cuidado con este procedimiento, ya que el cambio afecta a los consumidores existentes cuyo acceso se basa en el nombre anterior. Los consumidores no son notificados directamente ni actualizados.

Sintaxis

PROCEDURE RENAME_SHARE  
(
    old_share_name       IN VARCHAR2,
    new_share_name       IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
old_share_name El nombre actual del recurso compartido.
new_share_name El nuevo nombre del recurso compartido.
share_owner Propietario de la acción.
auto_commit Si es TRUE, los cambios se confirman automáticamente. Los cambios no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es TRUE.

Procedimiento RENAME_SHARE_LINK

Cambie el nombre de un enlace de recurso compartido registrado.

Sintaxis

PROCEDURE RENAME_SHARE_LINK  
(
    old_name             IN VARCHAR2,
    new_name             IN VARCHAR2,
    link_owner           IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
old_name El nombre actual del enlace del recurso compartido.
new_name Nuevo nombre del enlace.
link_owner Propietario del enlace de recurso compartido. Se define por defecto en el esquema actual.

Procedimiento RENAME_SHARE_SCHEMA

Cambie el nombre de un esquema de recurso compartido.

Sintaxis

PROCEDURE RENAME_SHARE_SCHEMA  
(
    share_name           IN VARCHAR2,
    old_schema_name      IN VARCHAR2,
    new_schema_name      IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
old_schema_name Nombre antiguo del esquema.
new_schema_name Nuevo nombre del esquema.
share_owner Propietario de la acción. Se define por defecto en el esquema actual.
auto_commit Si es TRUE, los cambios se confirman automáticamente. Los cambios no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es FALSO.

Procedimiento RENAME_SHARE_TABLE

Cambie el nombre de una tabla de recursos compartidos.

Sintaxis

PROCEDURE RENAME_SHARE_TABLE  
(
    share_name           IN VARCHAR2,
    share_schema_name    IN VARCHAR2,
    old_share_table_name IN VARCHAR2,
    new_share_table_name IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_schema_name Nombre del esquema de recurso compartido.
old_share_table_name El nombre antiguo de la tabla de recursos compartidos.
new_share_table_name El nuevo nombre de la tabla de recursos compartidos.
share_owner Propietario de la acción.
auto_commit Si es TRUE, los cambios se confirman automáticamente. Los cambios no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es FALSO.

Procedimiento REVOKE_FROM_RECIPIENT

Revocar el acceso a un recurso compartido de un destinatario específico.

Sintaxis

PROCEDURE REVOKE_FROM_RECIPIENT  
(
    share_name           IN VARCHAR2,
    recipient_name       IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name Nombre del recurso compartido que se va a revocar.
recipient_name Nombre del destinatario.
owner El propietario de la acción y el destinatario.
auto_commit Si es TRUE, los cambios se confirman automáticamente. Los cambios no son visibles externamente hasta que se realiza la confirmación. El valor por defecto es FALSO.

Procedimiento SET_CURRENT_SHARE_VERSION

Cambiar la versión actual de un recurso compartido.

Sintaxis

PROCEDURE SET_CURRENT_SHARE_VERSION  
(
    share_name         IN VARCHAR2,
    share_version      IN NUMBER,
    share_owner        IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_version La nueva versión o NULL. La versión debe existir y ser válida. Si share_version es NULL, ninguna versión se marcará como CURRENT y el recurso compartido será "unpublished".
share_owner Propietario de la acción. Se define por defecto en el esquema actual.

Procedimiento SET_PUBLISHED_IDENTITY

Defina los datos sobre el usuario actual que se proporcionarán a los destinatarios de los recursos compartidos de ORACLE publicados.

Sintaxis

PROCEDURE SET_PUBLISHED_IDENTITY  
(
    metadata             IN SYS.JSON_OBJECT_T := NULL  
);

Parámetros

parámetro Descripción
metadata Si la identidad del proveedor ya se ha definido, solo los elementos que el emisor de llamada desea actualizar deben incluirse en el JSON. Al proporcionar un valor NULL para un elemento, se elimina ese elemento de la identidad almacenada. Sin embargo, "nombre", "descripción" y "contacto" no se pueden eliminar de esta manera.

Si el argumento de metadatos es NULL, se suprime la identidad del proveedor existente. Esto solo puede suceder si el usuario actual no tiene recursos compartidos publicados.

Si la identidad del proveedor aún no se ha definido, el JSON debe contener al menos:
  • nombre (<=128 bytes)
  • descripción (<=4000 bytes)
  • valores de contacto (<=4000 bytes)

Se pueden incluir artículos adicionales a discreción de la persona que llama.

Ejemplo: inclusión de elementos adicionales en los metadatos de JSON

Además del "nombre", la "descripción" y el "contacto" necesarios, este ejemplo incluye el elemento adicional "schedule".
{
  "name" : "A sample share provider",
  "description" : "Test of share provider metadata",
  "contact" : "provider1@example.com".
  "schedule" : "New data provided on alternate rainy Fridays"
}

Ejemplo: actualización de "descripción" y eliminación de "programa"

Para actualizar "descripción" y eliminar "programa", se puede utilizar el siguiente JSON:
{
  "description" : "The Share Provider You Can Trust!(tm)",
  "schedule" : null
}

Procedimiento SET_RECIPIENT_LOG_LEVEL

Cambie el nivel de log de un destinatario de recurso compartido existente.

Sintaxis

PROCEDURE SET_RECIPIENT_LOG_LEVEL
(
  recipient_name       IN VARCHAR2,
  log_level            IN PLS_INTEGER,
  recipient_owner      IN VARCHAR2 := NULL
);

Parámetros

parámetro Descripción
recipient_name Nombre local del destinatario del recurso compartido.
log_level Nivel de registro de eventos. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Nivel de log en DBMS_SHARE Constants.
recipient_owner Esquema propietario del destinatario.

Procedimiento SET_SHARE_LOG_LEVEL

Cambiar el nivel de log de un recurso compartido existente.

Sintaxis

PROCEDURE SET_SHARE_LOG_LEVEL
(
  share_name           IN VARCHAR2,
  log_level            IN PLS_INTEGER,
  share_owner          IN VARCHAR2 := NULL
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
log_level Nivel de registro de eventos. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Nivel de log en DBMS_SHARE Constants.
share_owner Propietario de la acción.

Procedimiento SET_STORAGE_CREDENTIAL

Defina el nombre de credencial utilizado por el usuario actual cuando intente acceder al almacenamiento proporcionado.

Sintaxis

PROCEDURE SET_STORAGE_CREDENTIAL  
(
    storage_link_name    IN VARCHAR2,
    credential_name      IN VARCHAR2,
    owner                IN VARCHAR2 := NULL,
    check_if_exists      IN BOOLEAN := TRUE,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
storage_link_name Nombre de un enlace de almacenamiento en la nube creado anteriormente mediante el procedimiento CREATE_CLOUD_STORAGE_LINK.
credential_name Nombre de una credencial local que proporciona acceso al almacenamiento.

Las credenciales utilizadas para el almacenamiento de recursos compartidos deben poder leer, escribir, suprimir y gestionar solicitudes autenticadas previamente. Consulte Uso de solicitudes autenticadas previamente
owner El propietario del enlace de almacenamiento en la nube. Deje NULL para el usuario actual.
check_if_exists Si check_if_exists es TRUE, la función también confirmará que la credencial existe para el usuario actual.
auto_commit El valor por defecto es TRUE. Si es TRUE, esta transacción se confirma. Si es FALSE, el usuario debe confirmar la transacción. Los cambios no son visibles hasta que se realiza la confirmación.

Procedimiento STOP_JOB

Intente parar un trabajo de recurso compartido en ejecución. El procedimiento debe volver rápidamente, pero el trabajo asociado puede tardar un tiempo en detenerse.

Sintaxis

PROCEDURE STOP_JOB
(
  share_job_id         IN NUMBER,
  share_job_owner      IN VARCHAR2 := NULL
);

Parámetros

parámetro Descripción
share_job_id ID del trabajo de recurso compartido.
share_job_owner El propietario del trabajo. Se define por defecto en el esquema actual.

Procedimiento UNPUBLISH_SHARE

Anule la publicación de un recurso compartido.

Sintaxis

PROCEDURE UNPUBLISH_SHARE  
(
    share_name           IN VARCHAR2,
    out_share_job_id     IN OUT NOCOPY NUMBER,
    share_owner          IN VARCHAR2 := NULL,
    drop_all_versions    IN BOOLEAN := FALSE,
    restart_versions     IN BOOLEAN := FALSE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
out_share_job_id El ID de cualquier trabajo de recurso compartido que se deba ejecutar para procesar este comando.
share_owner Propietario de la acción. Se define por defecto en el esquema actual.
drop_all_versions Si se define en TRUE, se borran todas las versiones existentes junto con todo el almacenamiento asociado.

Si drop_all_versions es FALSE, todas las versiones existentes siguen existiendo, pero los destinatarios no pueden ver el recurso compartido. Una llamada posterior a PUBLISH_SHARE o SET_CURRENT_SHARE_VERSION los vuelve a ver.

restart_versions Reinicie la numeración de versiones. Si es FALSE, el siguiente número de versión publicada será el mismo que si no se hubiera borrado ninguna versión.

Si es TRUE, la siguiente versión publicada se establecerá en una versión más que la versión más alta existente. Cuando se utiliza junto con drop_all_versions, esto tiene el efecto de restablecer el recurso compartido a su estado original. Tenga en cuenta que esto puede confundir a cualquier cliente delta existente, por lo que debe usarse con cuidado.

Procedimiento UPDATE_DEFAULT_RECIPIENT_PROPERTY

Actualice los valores de propiedad de destinatario por defecto. Este procedimiento requiere que el usuario tenga privilegios de administrador.

Sintaxis

PROCEDURE UPDATE_DEFAULT_RECIPIENT_PROPERTY
(
  recipient_property   IN VARCHAR2,
  new_value_vc         IN VARCHAR2
);

Parámetros

parámetro Descripción
recipient_property Propiedad que se va a actualizar. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Share Recipient Properties en DBMS_SHARE Constants.
new_value_vc Nuevo valor de la propiedad.

Procedimiento UPDATE_DEFAULT_SHARE_PROPERTY

Actualice los valores predeterminados de la propiedad de recurso compartido.

Sintaxis

PROCEDURE UPDATE_DEFAULT_SHARE_PROPERTY  
(
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2  
);

Parámetros

parámetro Descripción
share_property Propiedad que se va a actualizar. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Propiedades de recurso compartido en DBMS_SHARE Constants.

Estas propiedades se pueden leer mediante la vista ALL_SHARE_DEFAULT_SETTINGS.

new_value Nuevo valor de la propiedad.

Procedimiento UPDATE_RECIPIENT_PROPERTY

Actualizar una propiedad de un destinatario existente.

Sintaxis

PROCEDURE UPDATE_RECIPIENT_PROPERTY  
(
    recipient_name       IN VARCHAR2,
    recipient_property   IN VARCHAR2,
    new_value            IN VARCHAR2,
    recipient_owner      IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
recipient_name Nombre del destinatario.
recipient_property Propiedad que se va a actualizar. En estas propiedades se incluye:
  • PROP_RECIPIENT_EMAIL
  • PROP_RECIPIENT_DESCRIPTION
  • PROP_RECIPIENT_LOG_LEVEL
  • PROP_RECIPIENT_SHARING_ID
  • PROP_RECIPIENT_PROFILE_URL
  • PROP_RECIPIENT_PAR_TYPE
  • PROP_RECIPIENT_MIN_PAR_LIFETIME
  • PROP_RECIPIENT_PAR_LIFETIME
  • PROP_RECIPIENT_TOKEN_LIFETIME
Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Share Recipient Recipient Properties en DBMS_SHARE Constants.
new_value Nuevo valor de la propiedad.
recipient_owner Propietario del destinatario. Se define por defecto en el esquema actual.

Procedimiento UPDATE_SHARE_JOB_PROPERTY

Modificar propiedades de un trabajo de recurso compartido en ejecución. El procedimiento debe volver rápidamente, pero los cambios pueden tardar algún tiempo en surtir efecto.

Sintaxis

PROCEDURE UPDATE_SHARE_JOB_PROPERTY  
(
    share_job_id         IN NUMBER,
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_job_owner      IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
share_job_id ID del trabajo de recurso compartido.
share_property Propiedad que se va a actualizar. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Compartir propiedades de trabajo en DBMS_SHARE Constants.
new_value Nuevo valor de la propiedad.
share_job_owner El propietario del trabajo. Se define por defecto en el esquema actual.

Procedimiento UPDATE_SHARE_PROPERTY

Actualizar una propiedad de un recurso compartido existente.

Sintaxis

PROCEDURE UPDATE_SHARE_PROPERTY  
(
    share_name           IN VARCHAR2,
    share_property       IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_property Propiedad que se va a actualizar. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Propiedades de recurso compartido en DBMS_SHARE Constants.
new_value Nuevo valor de la propiedad.
share_owner Propietario de la acción. Se define por defecto en el esquema actual.
Auto_commit Si es TRUE (valor por defecto), los cambios se confirman automáticamente. Si es FALSE, el usuario debe confirmar los cambios. Los cambios son visibles externamente después de que se realiza la confirmación.

Procedimiento UPDATE_SHARE_TABLE_PROPERTY

Actualice el valor de propiedad de una tabla de recursos compartidos existente.

Sintaxis

PROCEDURE UPDATE_SHARE_TABLE_PROPERTY  
(
    share_name           IN VARCHAR2,
    share_table_name     IN VARCHAR2,
    share_table_property IN VARCHAR2,
    new_value            IN VARCHAR2,
    share_schema_name    IN VARCHAR2 := NULL,
    share_owner          IN VARCHAR2 := NULL,
    auto_commit          IN BOOLEAN := TRUE  
);

Parámetros

parámetro Descripción
share_name El nombre del recurso compartido.
share_table_name El nombre de la tabla de recursos compartidos.
share_table_property Propiedad que se va a actualizar. En estas propiedades se incluye:
  • PROP_SHARE_TABLE_SPLIT_METHOD
  • PROP_SHARE_TABLE_SPLIT_COLUMNS
  • PROP_SHARE_TABLE_ORDER_COLUMNS
  • PROP_SHARE_TABLE_SHARE_COLUMNS
  • PROP_SHARE_TABLE_SPLIT_SIZE
  • PROP_SHARE_TABLE_GATHER_STATS
  • PROP_SHARE_TABLE_SPLIT_ROWS
  • PROP_SHARE_TABLE_FLASHBACK
new_value Nuevo valor de la propiedad.
share_schema_name El nombre del esquema de recurso compartido (el valor por defecto es mayúscula del usuario actual).
share_owner Propietario de la acción. Se define por defecto en el esquema actual.
Auto_commit Si es TRUE (valor por defecto), los cambios se confirman automáticamente. Si es FALSE, el usuario debe confirmar los cambios. Los cambios son visibles externamente después de que se realiza la confirmación.

Función VALIDATE_CREDENTIAL

Valide un nombre de credencial y, si es necesario, conviértalo en formato canónico.

El procedimiento emite una excepción si el nombre no es un identificador de Oracle válido. El valor credential_name se devuelve sin comillas dobles, como aparecería en la columna CREDENTIAL_NAME de la vista USER_CREDENTIALS.

Sintaxis

FUNCTION VALIDATE_CREDENTIAL  
(
        credential_name      IN VARCHAR2,
        check_if_exists      IN BOOLEAN := TRUE  
)  
RETURN VARCHAR2;

Parámetros

parámetro Descripción
credential_name Nombre de la credencial que se va a validar en formato de base de datos estándar, con comillas dobles si el nombre no es un identificador simple.
check_if_exists Si es TRUE, la función también confirma que la credencial existe para el usuario actual.

Procedimiento VALIDATE_SHARE_STORAGE

Compruebe si el almacenamiento determinado es adecuado para recursos compartidos versionados.

Sintaxis

Sintaxis del procedimiento, incluido el parámetro de salida validation_results. 

 PROCEDURE VALIDATE_SHARE_STORAGE  
(
    storage_link_name    IN VARCHAR2,
    validation_results   IN OUT NOCOPY VARCHAR2,
    run_storage_tests    IN BOOLEAN := TRUE,
    storage_link_owner   IN VARCHAR2 := NULL  
);

La sintaxis del procedimiento no incluye el parámetro de salida validation_results. 

PROCEDURE VALIDATE_SHARE_STORAGE  
(
    storage_link_name    IN VARCHAR2,
    run_storage_tests    IN BOOLEAN := TRUE,
    storage_link_owner   IN VARCHAR2 := NULL  
);

Parámetros

parámetro Descripción
storage_link_name Nombre del enlace de almacenamiento en la nube.
validation_results (Entrada y salida opcionales) Detalles de resultado de validación devueltos en formato JSON.

validation_results incluye los resultados de cada prueba independiente.

run_storage_tests Ejecute pruebas para validar el almacenamiento. Si es TRUE (valor por defecto), el procedimiento prueba READ, WRITE, DELETE y PREAUTHENTICATED REQUESTS (Solicitudes de lectura, escritura, supresión y autorización).
storage_link_owner El propietario del enlace de almacenamiento en la nube.

Ejemplo: resultados de validación

{
  "READ":"PASSSED",
  "WRITE":"PASSSED",
  "CREATE_PAR":"PASSSED",
  "DELETE_PAR":"PASSSED",
  "DELETE":"PASSSED"
}

Procedimiento WAIT_FOR_JOB

Este procedimiento espera hasta que se complete el trabajo de recursos compartidos especificado.

Sintaxis

PROCEDURE WAIT_FOR_JOB  
(
    share_job_id         IN NUMBER,
    completed            IN OUT NOCOPY BOOLEAN,
    maximum_wait         IN NUMBER := NULL  
);

Parámetros

parámetro Descripción
share_job_id ID del trabajo de recurso compartido.
completed Indicador de finalización de trabajo.
maximum_wait Período de espera máximo, en segundos. Un valor NULL no implica ningún límite.