Documentación de Oracle Cloud Infrastructure

Resumen de subprogramas de productor de acciones

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

Subprograma Descripción
Procedimiento ADD_TO_SHARE Agregar una tabla o vista a un recurso compartido.
Procedimiento ASSERT_SHAREABLE_OBJECT Devolver sin error, si el objeto existe y se puede compartir.
Procedimiento ASSERT_SHARING_ID Ejecute comprobaciones de validación básicas con un ID de uso compartido y devuelva uno en forma canónica.
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 Borrar eventos del log de eventos de destinatarios de recursos compartidos.
Procedimiento CLEAR_SHARE_EVENTS Borrar eventos del log de eventos del recurso compartido.
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_DELTA_SHARE_PROVIDER Suscribirse a un proveedor de recursos compartidos delta definido por un perfil de uso compartido delta.
Procedimiento CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Crear o sustituir un URI de almacenamiento en la nube con nombre.
Procedimiento CREATE_OR_REPLACE_DELTA_SHARE_PROVIDER Suscribirse o volver a suscribirse a un proveedor de recursos compartidos delta definido por un perfil de uso compartido delta.
Procedimiento CREATE_OR_REPLACE_SHARE_RECIPIENT Crear o sustituir un destinatario de recursos compartidos.
Procedimiento CREATE_SHARE Cree un objeto de recurso 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 Borrar un recurso compartido y todo su contenido.
Procedimiento DROP_SHARE_LINK_VIEW Borre una vista creada por 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 GENERATE_SHARE_PROFILE Genere y devuelva un perfil de uso compartido delta como CLOB.
Función GET_ACTIVATION_LINK Genere el enlace que se coloca en los correos electrónicos al destinatario autorizado.
Función GET_PUBLISHED_IDENTITY Obtenga datos sobre el usuario actual que ha definido 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 Otorgue acceso a un recurso compartido a un destinatario específico.
Procedimiento POPULATE_SHARE_PROFILE Generación de un perfil delta para un destinatario.
Procedimiento PUBLISH_SHARE Publique un recurso compartido y vuelva inmediatamente.
Procedimiento PUBLISH_SHARE_WAIT Publique un recurso compartido y espere hasta que se complete el trabajo en segundo plano.
Procedimiento PURGE_DETACHED_FILES Eliminar u olvidar los archivos de parquet que se han desprendido de sus recursos compartidos.
Procedimiento REMOVE_FROM_SHARE Eliminar una tabla o 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 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 recursos compartidos existente.
Procedimiento SET_SHARE_LOG_LEVEL Cambie 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 Detenga un trabajo de recurso compartido en ejecución.
Procedimiento UNPUBLISH_SHARE Anular 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 de propiedad de recurso compartido por defecto.
Procedimiento UPDATE_RECIPIENT_PROPERTY Actualización de una propiedad de un destinatario existente.
Procedimiento UPDATE_SHARE_JOB_PROPERTY Modificar las propiedades de un trabajo compartido en ejecución.
Procedimiento UPDATE_SHARE_PROPERTY Actualice 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 conviértalo en forma canónica en primer lugar si es necesario.
Procedimiento VALIDATE_DELTA_PROFILE Compruebe si un perfil de uso compartido delta está en uno de los formatos JSON soportados.
Procedimiento VALIDATE_SHARE_STORAGE Compruebe si el almacenamiento proporcionado es adecuado para los recursos compartidos versionados.
Procedimiento WAIT_FOR_JOB Este procedimiento espera hasta que se complete el trabajo de recursos compartidos especificado.

ADD_TO_SHARE Procedimiento

Agregar 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 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 El 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úsculas.
share_schema_name Esquema visible externamente en el que se colocará la tabla. Por defecto, 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 a 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 valor share_table_name ya existe, se emite una excepción que indica que la tabla de recursos compartidos ya está en uso.
share_owner El propietario de la acción.
auto_commit Si es TRUE, esta llamada al procedimiento confirma los cambios que no están 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.

ASSERT_SHAREABLE_OBJECT Procedimiento

Devolver sin error, 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. El valor por defecto es el esquema actual.

ASSERT_SHARING_ID Procedimiento

Ejecute comprobaciones de validación básicas con un ID de uso compartido y devuelva uno en forma canónica. Se emite una excepción si el ID es obviamente no 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 ID que se va a comprobar.
out_sharing_id_type El 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 1 y 0 de lo contrario.

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 1 y 0 de lo contrario.

Sintaxis

FUNCTION CAN_CREATE_SHARE_RECIPIENT
RETURN NUMBER;

CLEAR_RECIPIENT_EVENTS Procedimiento

Borrar eventos del log de eventos de destinatarios de recursos compartidos.

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 Hora más temprana para eventos que se deben borrar o NULL.
to_time Última hora para eventos que se deben borrar o NULL.
recipient_owner El esquema que posee el destinatario.

CLEAR_SHARE_EVENTS Procedimiento

Borrar eventos del log de eventos del recurso compartido.

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 Nombre del recurso compartido.
from_time Hora más temprana para eventos que se deben borrar o NULL.
to_time Última hora para eventos que se deben borrar o NULL.
share_owner El esquema propietario del recurso compartido.

CREATE_BEARER_TOKEN_CREDENTIAL Procedimiento

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 Procedimiento y función CREATE_CREDENTIALS 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
   token_scope          IN VARCHAR2 := NULL
   grant_type           IN VARCHAR2 :=
    'client_credentials'
);

Parámetros

Parámetro Descripción
credential_name Nombre de la nueva credencial.
bearer_token El símbolo del portador, si se conoce.
token_endpoint Punto final al que llamar para obtener un nuevo token.
client_id Nombre de usuario que se debe enviar a token_endpoint.
client_secret Contraseña que se enviará a token_endpoint.
token_refresh_rate Tiempo de refrescamiento opcional, en segundos.
token_scope Especificación opcional del nivel de acceso del token.
grant_type Método opcional utilizado para obtener el token.

Ejemplo: credencial con un token de portador fijo

En su forma más simple, este procedimiento es equivalente a llamar a DBMS_CREDENTIAL con un nombre de usuario de 'BEARER_TOKEN' y el propio token de portador 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 con 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..

CREATE_CLOUD_STORAGE_LINK Procedimiento

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

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 URI del cubo de almacenamiento. El URI debe tener el formato https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Propietario del enlace de almacenamiento. Dejar como 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 ha confirmado. 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_DELTA_SHARE_PROVIDER

Suscribirse a un proveedor de recursos compartidos delta definido por un perfil de uso compartido delta.

Sintaxis

PROCEDURE CREATE_DELTA_SHARE_PROVIDER
(
    provider_name      IN VARCHAR2,
    delta_profile      IN CLOB,
    owner              IN VARCHAR2 := NULL,
    metadata           IN SYS.JSON_OBJECT_T := NULL,
    create_credentials IN BOOLEAN := TRUE,
    auto_commit        IN BOOLEAN := TRUE
);

Parámetros

Parámetro Descripción
provider_name Nombre del proveedor de recursos compartidos delta recientemente suscrito.
delta_profile El perfil de uso compartido delta, en formato CLOB. Consulte VALIDATE_DELTA_PROFILE para conocer los formatos soportados.
owner Usuario que se está suscribiendo al proveedor. El valor por defecto es el esquema actual.
metadata Usuario que se está suscribiendo al proveedor. El valor por defecto es el esquema actual.
create_credentials Si es TRUE, las credenciales se crean a partir del perfil delta y se asocian al proveedor. Si FALSE, las credenciales se deben crear por separado.
auto_commit Descripción pública del recurso compartido.

CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Procedimiento

Crear o sustituir 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

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 URI del cubo de almacenamiento. El URI debe tener el formato https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucket/o
owner Propietario del enlace de almacenamiento. El valor por defecto es 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_DELTA_SHARE_PROVIDER

Suscribirse o volver a suscribirse a un proveedor de recursos compartidos delta definido por un perfil de uso compartido delta.

Sintaxis

PROCEDURE CREATE_OR_REPLACE_DELTA_SHARE_PROVIDER
(
    provider_name      IN VARCHAR2,
    delta_profile      IN CLOB,
    owner              IN VARCHAR2 := NULL,
    metadata           IN SYS.JSON_OBJECT_T := NULL,
    create_credentials IN BOOLEAN := TRUE,
    auto_commit        IN BOOLEAN := TRUE
);

Parámetros

Parámetro Descripción
provider_name Nombre del proveedor de recursos compartidos delta recientemente suscrito.
delta_profile El perfil de uso compartido delta, en formato CLOB. Consulte VALIDATE_DELTA_PROFILE para conocer los formatos soportados.
owner Usuario que se está suscribiendo al proveedor. El valor por defecto es el esquema actual.
metadata (Opcional) Metadatos de JSON que asociar al proveedor.
create_credentials Si es TRUE, las credenciales se crean a partir del perfil delta y se asocian al proveedor. Las credenciales existentes para el proveedor se borran y se vuelven a crear. Si FALSE, las credenciales se deben crear por separado.
auto_commit Si es TRUE, los cambios se confirman automáticamente. El valor por defecto es TRUE.

CREATE_OR_REPLACE_SHARE_RECIPIENT Procedimiento

Crear o sustituir un destinatario de recursos compartidos. Debes proporcionar al menos una dirección de correo electrónico o ID para compartir.

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 El esquema que posee el destinatario.
email Un correo electrónico que se registrará para el usuario OAUTH.
sharing_id El ID de uso compartido del destinatario, de Función GET_SHARING_ID.

CREATE_SHARE Procedimiento

Cree un objeto de recurso 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 Nombre del recurso compartido. Este nombre está en mayúsculas, ya que los recursos compartidos delta no distinguen entre mayúsculas y minúsculas. Este nombre sigue las convenciones estándar de Oracle, por lo que debe tener un mínimo de 128 caracteres y debe estar entre comillas dobles si no es un identificador simple. La única diferencia es que estará en mayúsculas, incluso si está entre comillas dobles.
share_type El tipo de recurso compartido. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Share Types en DBMS_SHARE Constants.
storage_link_name Nombre del enlace de almacenamiento en la nube donde 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 El propietario de la acción.
auto_commit Si es TRUE, esta llamada al procedimiento confirma los cambios que no están 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 Log Level 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 dar lugar a errores más adelante, durante la publicación o el consumo de la acción.

Oracle recomienda especificar TRUE para este parámetro.

CREATE_SHARE_RECIPIENT Procedimiento

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 El esquema que posee el destinatario.
email Un correo electrónico que se registrará para el usuario OAUTH. Debes proporcionar al menos uno de los correos electrónicos o ID de uso compartido.
sharing_id ID de uso compartido del destinatario de la función GET_SHARING_ID. Debes proporcionar al menos uno de los correos electrónicos o ID de uso compartido.

DROP_CLOUD_STORAGE_LINK Procedimiento

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 Propietario del enlace de almacenamiento en la nube. Dejar como 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.

DROP_RECIPIENT Procedimiento

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.

DROP_SHARE Procedimiento

Borrar un recurso compartido y todo su contenido. El acceso futuro a la cuota por parte 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 Nombre del recurso compartido que se va a borrar.
share_owner El propietario del recurso compartido que se va a distribuir.
destroy_objects Si es TRUE, suprima todos los objetos creados en nombre del recurso compartido. El valor por defecto es TRUE.

DROP_SHARE_LINK_VIEW Procedimiento

Borre una vista creada por 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 Nombre de la nueva vista.
view_owner El propietario de la vista. El esquema actual es el valor por defecto.

DROP_SHARE_VERSION Procedimiento

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 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 El propietario de la acción.

DROP_SHARE_VERSIONS Procedimiento

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 Nombre del recurso compartido.
from_share_version Versión inferior que se va a 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 El propietario de la acción.

DROP_UNUSED_SHARE_VERSIONS Procedimiento

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 Nombre del recurso compartido.
destroy_objects Destruya cualquier objeto asociado en el almacenamiento en la nube, si corresponde.
share_owner El propietario de la acción.

ENABLE_SCHEMA Procedimiento

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

Sintaxis

Los usuarios pueden consumir recursos compartidos delta sin activarse 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 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
    Permite a los usuarios crear un recurso compartido de publicación en su propio esquema.
    PRIV_CREATE_SHARE CONSTANT PLS_INTEGER := 1;

  • PRIV_CREATE_RECIPIENT

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

    PRIV_CREATE_RECIPIENT CONSTANT PLS_INTEGER := 2;
  • PRIV_CONSUME_ORACLE_SHARE

    Permite a los usuarios consumir recursos compartidos en vivo 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 GENERATE_SHARE_PROFILE

    Genere y devuelva un perfil de uso compartido delta como CLOB. Este perfil se puede imprimir, almacenar o cargar para que el destinatario lo use al suscribirse al recurso compartido.

    Sintaxis

    FUNCTION GENERATE_SHARE_PROFILE
(
    recipient_name       IN VARCHAR2,
    recipient_owner      IN VARCHAR2 := NULL,
    credentials_version  IN PLS_INTEGER := NULL,
    base_endpoint        IN VARCHAR2 := NULL,
    revoke_existing      IN BOOLEAN := TRUE,
    revoke_sessions      IN BOOLEAN := FALSE
)
RETURN CLOB;

    Parámetros

    Parámetro Descripción
    recipient_name Nombre local del destinatario.
    recipient_owner El esquema que posee el destinatario. El valor por defecto es el esquema actual.
    credentials_version El valor shareCredentialsVersion necesario. Especifique NULL para utilizar la versión por defecto.
    base_endpoint (Opcional) Sustitución para el punto final base ORDS. Especifique esta opción si el punto final por defecto es incorrecto debido a problemas de red o URL personalizadas.
    revoke_existing Si es TRUE, el secreto de cliente anterior para este cliente se invalida. El valor por defecto es TRUE.
    revoke_sessions Si es TRUE, las sesiones de ORDS existentes para este cliente se invalidan. El valor por defecto es FALSE.

    Función GET_ACTIVATION_LINK

    Genere el enlace que se coloca en los correos electrónicos al destinatario autorizado. Este enlace de activación lleva 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 El esquema que posee el destinatario.
    expiration Número de segundos antes de que caduque el enlace de activación.
    invalidate_previous Si es TRUE, que es el valor por defecto, un enlace de activación generado previamente no es válido. Si es FALSE, un enlace de activación generado previamente sigue siendo válido. 
    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 que ha definido 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 La propiedad para conseguir. Entre estas propiedades se incluyen:
    • 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 Share Properties en [DBMS_SHARE Constants](dbms-share-package-constants.html#GUID-F35B1B50-7345-4ECC-B28B-85B1878EFC3D).

    recipient_owner Propietario del destinatario. El valor predeterminado 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 Nombre del recurso compartido.
    share_property Valor de propiedad que se va a obtener. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Share Properties en DBMS_SHARE Constants.
    share_owner El propietario de la acción. El valor predeterminado 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 Nombre del recurso compartido.
    share_table_name Nombre de la tabla de recursos compartidos.
    share_table_property Propiedad de la tabla de recursos compartidos que se va a actualizar. Para obtener información sobre las constantes utilizadas para este parámetro, consulte las descripciones de Share Table Properties en DBMS_SHARE Constants.
    share_schema_name Nombre del esquema de recurso compartido. El valor predeterminado es mayúscula del usuario actual.
    share_owner El propietario de la acción.

    GRANT_TO_RECIPIENT Procedimiento

    Otorgue acceso a 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 Propietario de la acción y del destinatario.
    auto_commit Se ignora el parámetro auto_commit. Este procedimiento siempre se confirmará.

    POPULATE_SHARE_PROFILE Procedimiento

    Genere el perfil de uso compartido delta directamente en un objeto JSON. Esto es útil cuando desea evitar devolver el perfil como CLOB y, en su lugar, trabajar con un objeto JSON en su lugar.

    Sintaxis

    PROCEDURE POPULATE_SHARE_PROFILE
(
    recipient_name       IN VARCHAR2,
    share_profile        IN OUT NOCOPY SYS.JSON_OBJECT_T,
    recipient_owner      IN VARCHAR2 := NULL,
    credentials_version  IN PLS_INTEGER := NULL,
    base_endpoint        IN VARCHAR2 := NULL,
    revoke_existing      IN BOOLEAN := TRUE,
    revoke_sessions      IN BOOLEAN := FALSE
);

    Parámetros

    Parámetro Descripción
    recipient_name Nombre local del destinatario.
    recipient_owner El esquema que posee el destinatario. El valor por defecto es el esquema actual.
    share_profile El perfil de recurso compartido, sin token de portador.
    credentials_version El valor shareCredentialsVersion necesario. Especifique como NULL para utilizar la versión por defecto.
    base_endpoint (Opcional) Sustitución para el punto final base ORDS. Utilice esta opción si el punto final por defecto es incorrecto debido a problemas de red o URL personalizadas.
    revoke_existing Si es TRUE, el secreto de cliente anterior para este cliente se invalida. El valor por defecto es TRUE.
    revoke_sessions Si es TRUE, las sesiones de ORDS existentes para este cliente se invalidan. El valor por defecto es FALSE.

    PUBLISH_SHARE Procedimiento

    Publique un recurso compartido y vuelva 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 Nombre del recurso compartido que se va a publicar.
    share_owner El propietario del recurso compartido, que debe ser el usuario actual o NULL.
    drop_prior_versions Establézcalo en Verdadero 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 usar el número por defecto del sistema.
    share_job_priority Especifique una prioridad relativa de esta publicación compartida 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 aunque el administrador haya definido una clase de trabajo por defecto diferente.

    PUBLISH_SHARE_WAIT Procedimiento

    Publique un recurso compartido y espere hasta que se complete el trabajo en segundo plano. La publicación continúa incluso si se interrumpe 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 Nombre del recurso compartido que se va a publicar.
    share_owner El propietario del recurso compartido, que debe ser el usuario actual o NULL.
    drop_prior_versions Establézcalo en Verdadero 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 usar el número por defecto del sistema.
    share_job_priority Especifique una prioridad relativa de esta publicación compartida 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 aunque el administrador haya definido una clase de trabajo por defecto diferente.

    PURGE_DETACHED_FILES Procedimiento

    Eliminar u olvidar los archivos de parquet que se han desprendido 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')
);

    Una 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 del 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 borrarlos.

      PURGE_FORGET CONSTANT PLS_INTEGER := 3;
    owner_id ID del propietario cuyos archivos se van a depurar.

    REMOVE_FROM_SHARE Procedimiento

    Eliminar una tabla o 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 Nombre de un recurso compartido existente al que se revoca el objeto.
    share_table_name Nombre de la tabla de recursos compartidos que desea revocar. Debe coincidir con el nombre visible externamente, por lo que la entrada se superpondrá.
    share_schema_name Nombre del esquema de recurso compartido. El valor predeterminado es mayúscula del usuario actual.
    share_owner El propietario de la acción.
    auto_commit Si es TRUE, esta llamada al procedimiento confirma los cambios que no están 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.

    RENAME_RECIPIENT Procedimiento

    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.

    RENAME_SHARE Procedimiento

    Cambie el nombre de un recurso compartido. Se debe tener cuidado con este procedimiento, ya que el cambio afecta a cualquier consumidor existente 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 Nombre actual del recurso compartido.
    new_share_name El nuevo nombre del uso compartido.
    share_owner El 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.

    RENAME_SHARE_LINK Procedimiento

    Cambie el nombre de un enlace 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 Nombre actual del enlace de recurso compartido.
    new_name El nuevo nombre del enlace.
    link_owner Propietario del enlace de recurso compartido. El valor por defecto es el esquema actual.

    RENAME_SHARE_SCHEMA Procedimiento

    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 Nombre del recurso compartido.
    old_schema_name El nombre antiguo del esquema.
    new_schema_name El nuevo nombre del esquema.
    share_owner El propietario de la acción. El valor por defecto es 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.

    RENAME_SHARE_TABLE Procedimiento

    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 Nombre del recurso compartido.
    share_schema_name Nombre del esquema de recurso compartido.
    old_share_table_name Nombre antiguo de la tabla de recursos compartidos.
    new_share_table_name El nuevo nombre de la tabla de recursos compartidos.
    share_owner El 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.

    REVOKE_FROM_RECIPIENT Procedimiento

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

    SET_CURRENT_SHARE_VERSION Procedimiento

    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 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 se "anulará la publicación".
    share_owner El propietario de la acción. El valor por defecto es el esquema actual.

    SET_PUBLISHED_IDENTITY Procedimiento

    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 se deben incluir en el JSON los elementos que el emisor de llamada desea actualizar. Si se proporciona un valor NULL para un artículo, este se elimina 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)< li>
    • descripción (<=4000 bytes)< li>
    • valores de contacto (<=4000 bytes)< li>

    Los elementos adicionales pueden ser incluidos a discreción del llamante.

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

    Además del "nombre", la "descripción" y el "contacto" necesarios, en este ejemplo se incluye el elemento adicional "programa".

    {
  "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 la "descripción" y eliminar la "programación", se puede utilizar el siguiente JSON:

    {
  "description" : "The Share Provider You Can Trust!(tm)",
  "schedule" : null
}

    SET_RECIPIENT_LOG_LEVEL Procedimiento

    Cambie el nivel de log de un destinatario de recursos compartidos 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 Log Level en DBMS_SHARE Constants.
    recipient_owner El esquema que posee el destinatario.

    SET_SHARE_LOG_LEVEL Procedimiento

    Cambie 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 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 Log Level en DBMS_SHARE Constants.
    share_owner El propietario de la acción.

    SET_STORAGE_CREDENTIAL Procedimiento

    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 El 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 Propietario del enlace de almacenamiento en la nube. Dejar como 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 ha confirmado. Si es FALSE, el usuario debe confirmar la transacción. Los cambios no son visibles hasta que se realiza la confirmación.

    STOP_JOB Procedimiento

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

    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 compartido.
    share_job_owner Propietario del trabajo. El valor por defecto es el esquema actual.

    UNPUBLISH_SHARE Procedimiento

    Anular 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 Nombre del recurso compartido.
    out_share_job_id ID de cualquier trabajo de recurso compartido que se deba ejecutar para procesar este comando.
    share_owner El propietario de la acción. El valor por defecto es el esquema actual.
    drop_all_versions Si se establece en Verdadero, 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 el recurso compartido no está visible para los destinatarios. Una llamada posterior a PUBLISH_SHARE o SET_CURRENT_SHARE_VERSION los hace visibles de nuevo.
    restart_versions Reinicie la numeración de versiones. Si FALSE, el siguiente número de versión publicado será el mismo que habría sido si no se hubiera borrado ninguna versión. Si es TRUE, la siguiente versión publicada se definirá en una más que la versión existente más alta. 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.

    UPDATE_DEFAULT_RECIPIENT_PROPERTY Procedimiento

    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 El nuevo valor de la propiedad.

    UPDATE_DEFAULT_SHARE_PROPERTY Procedimiento

    Actualice los valores de propiedad de recurso compartido por defecto.

    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 las propiedades de recursos compartidos en DBMS_SHARE Constants. Estas propiedades se pueden leer mediante la vista ALL_SHARE_DEFAULT_SETTINGS.
    new_value El nuevo valor de la propiedad.

    UPDATE_RECIPIENT_PROPERTY Procedimiento

    Actualización de 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. Entre estas propiedades se incluyen:
    • 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](dbms-share-package-constants.html#GUID-F35B1B50-7345-4ECC-B28B-85B1878EFC3D).
    new_value El nuevo valor de la propiedad.
    recipient_owner Propietario del destinatario. El valor por defecto es el esquema actual.

    UPDATE_SHARE_JOB_PROPERTY Procedimiento

    Modificar las propiedades de un trabajo compartido en ejecución. El procedimiento debe volver rápidamente, pero puede tomar algún tiempo para que los cambios surtan 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 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 Share Job Properties en DBMS_SHARE Constants.
    new_value El nuevo valor de la propiedad.
    share_job_owner Propietario del trabajo. El valor por defecto es el esquema actual.

    UPDATE_SHARE_PROPERTY Procedimiento

    Actualice 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 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 Share Properties en DBMS_SHARE Constants.
    new_value El nuevo valor de la propiedad.
    share_owner El propietario de la acción. El valor por defecto es 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 realice la confirmación.

    UPDATE_SHARE_TABLE_PROPERTY Procedimiento

    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 Nombre del recurso compartido.
    share_table_name Nombre de la tabla de recursos compartidos.
    share_table_property Propiedad que se va a actualizar. Entre estas propiedades se incluyen:
    • 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 El nuevo valor de la propiedad.
    share_schema_name Nombre del esquema de recurso compartido (el valor por defecto es mayúscula del usuario actual).
    share_owner El propietario de la acción. El valor por defecto es 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 realice la confirmación.

    Función VALIDATE_CREDENTIAL

    Valide un nombre de credencial y conviértalo en forma canónica en primer lugar si es necesario.

    El procedimiento emite una excepción si el nombre no es un identificador de Oracle válido. credential_name se devuelve sin comillas dobles, ya que 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 el formulario 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_DELTA_PROFILE

    Compruebe si un perfil de uso compartido delta está en uno de los formatos JSON soportados. Este procedimiento sólo valida la estructura. No llama a los puntos finales ni verifica las credenciales.

    Sintaxis

    PROCEDURE VALIDATE_DELTA_PROFILE
(
    delta_profile IN CLOB
);

    Parámetros

    Parámetro Descripción
    delta_profile Perfil de uso compartido delta en formato JSON. Los perfiles soportados incluyen formatos de credencial versión 1 y versión 2.

    VALIDATE_SHARE_STORAGE Procedimiento

    Compruebe si el almacenamiento proporcionado es adecuado para los recursos compartidos versionados.

    Sintaxis

    Sintaxis del procedimiento que incluye 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 predeterminado), el procedimiento prueba READ (Lectura), WRITE (Escritura), DELETE (Eliminar) y PREAUTHENTICATED REQUESTS (Solicitudes previas).
    storage_link_owner 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"
}

    WAIT_FOR_JOB Procedimiento

    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 compartido.
    completed Indicador de finalización de trabajo.
    maximum_wait Período de espera máximo, en segundos. Un valor NULL implica que no hay límite.