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
ADD_TO_SHARE Procedimiento Agregar una tabla o vista a un recurso compartido.
ASSERT_SHAREABLE_OBJECT Procedimiento Devolver sin error, si el objeto existe y se puede compartir.
ASSERT_SHARING_ID Procedimiento 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.
CLEAR_RECIPIENT_EVENTS Procedimiento Borrar eventos del log de eventos de destinatarios de recursos compartidos.
CLEAR_SHARE_EVENTS Procedimiento Borrar eventos del log de eventos del recurso compartido.
CREATE_BEARER_TOKEN_CREDENTIAL Procedimiento Cree una credencial adecuada para su uso con proveedores de recursos compartidos delta.
CREATE_CLOUD_STORAGE_LINK Procedimiento Cree un enlace URI de almacenamiento en la nube con nombre.
CREATE_OR_REPLACE_CLOUD_STORAGE_LINK Procedimiento Crear o sustituir un URI de almacenamiento en la nube con nombre.
CREATE_OR_REPLACE_SHARE_RECIPIENT Procedimiento Crear o sustituir un destinatario de recursos compartidos.
CREATE_SHARE Procedimiento Cree un objeto de recurso compartido con nombre.
CREATE_SHARE_RECIPIENT Procedimiento Cree un nuevo destinatario de recursos compartidos.
DROP_CLOUD_STORAGE_LINK Procedimiento Borre un enlace de almacenamiento en la nube.
DROP_RECIPIENT Procedimiento Borrar un destinatario.
DROP_SHARE Procedimiento Borrar un recurso compartido y todo su contenido.
DROP_SHARE_LINK_VIEW Procedimiento Borre una vista creada por el procedimiento CREATE_SHARE_LINK_VIEW.
DROP_SHARE_VERSION Procedimiento Borre una única versión de recurso compartido.
DROP_SHARE_VERSIONS Procedimiento Borre un rango de versiones de recursos compartidos.
DROP_UNUSED_SHARE_VERSIONS Procedimiento Borre cualquier versión de recurso compartido que no esté en uso actualmente.
ENABLE_SCHEMA Procedimiento Activar o desactivar un esquema para compartir.
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.
GRANT_TO_RECIPIENT Procedimiento Otorgue acceso a un recurso compartido a un destinatario específico.
POPULATE_SHARE_PROFILE Procedimiento Generación de un perfil delta para un destinatario.
PUBLISH_SHARE Procedimiento Publique un recurso compartido y vuelva inmediatamente.
PUBLISH_SHARE_WAIT Procedimiento Publique un recurso compartido y espere hasta que se complete el trabajo en segundo plano.
PURGE_DETACHED_FILES Procedimiento Eliminar u olvidar los archivos de parquet que se han desprendido de sus recursos compartidos.
REMOVE_FROM_SHARE Procedimiento Eliminar una tabla o vista de un recurso compartido.
RENAME_RECIPIENT Procedimiento Cambiar el nombre de un destinatario.
RENAME_SHARE Procedimiento Cambie el nombre de un recurso compartido.
RENAME_SHARE_LINK Procedimiento Cambie el nombre de un enlace compartido registrado.
RENAME_SHARE_SCHEMA Procedimiento Cambie el nombre de un esquema de recurso compartido.
RENAME_SHARE_TABLE Procedimiento Cambie el nombre de una tabla de recursos compartidos.
REVOKE_FROM_RECIPIENT Procedimiento Revocar el acceso a un recurso compartido de un destinatario específico.
SET_CURRENT_SHARE_VERSION Procedimiento Cambiar la versión actual de un recurso compartido.
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.
SET_RECIPIENT_LOG_LEVEL Procedimiento Cambie el nivel de log de un destinatario de recursos compartidos existente.
SET_SHARE_LOG_LEVEL Procedimiento Cambie el nivel de log de un recurso compartido existente.
SET_STORAGE_CREDENTIAL Procedimiento Defina el nombre de la credencial de acceso para el almacenamiento proporcionado.
STOP_JOB Procedimiento Detenga un trabajo de recurso compartido en ejecución.
UNPUBLISH_SHARE Procedimiento Anular publicación de un recurso compartido.
UPDATE_DEFAULT_RECIPIENT_PROPERTY Procedimiento Actualice los valores de propiedad de destinatario por defecto.
UPDATE_DEFAULT_SHARE_PROPERTY Procedimiento Actualice los valores de propiedad de recurso compartido por defecto.
UPDATE_RECIPIENT_PROPERTY Procedimiento Actualización de una propiedad de un destinatario existente.
UPDATE_SHARE_JOB_PROPERTY Procedimiento Modificar las propiedades de un trabajo compartido en ejecución.
UPDATE_SHARE_PROPERTY Procedimiento Actualice una propiedad de un recurso compartido existente.
UPDATE_SHARE_TABLE_PROPERTY Procedimiento 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.
VALIDATE_SHARE_STORAGE Procedimiento Compruebe si el almacenamiento proporcionado es adecuado para los recursos compartidos versionados.
WAIT_FOR_JOB Procedimiento 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, este 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 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 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.

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

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

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

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

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

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, desde GET_SHARING_ID Function.

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 Tipos de recursos compartidos en DBMS_SHARE Constantes.
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

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 CREATE_SHARE_LINK_VIEW Procedure para obtener más información.

Sintaxis

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

Parámetros

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

Ejemplo: Imprimir 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 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.

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

Generación de un perfil delta para un destinatario. Puede imprimirlo en la pantalla o cargarlo en algún lugar. Por ejemplo, en un cubo de objetos que utilice 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 El esquema que posee el 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.."
}

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

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)
  • descripción (<=4000 bytes)
  • valores de contacto (<=4000 bytes)

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

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

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.