ScriptsProxy Classe

Interfaccia da interagire con stored procedure.

Questa classe non deve essere creata direttamente. Usare invece l'attributo scripts .

Ereditarietà

builtins.object

ScriptsProxy

Costruttore

ScriptsProxy(container: ContainerProxy, client_connection: CosmosClientConnection, container_link: str)

Parametri

container

client_connection

container_link

Metodi

create_stored_procedure	Creare una nuova stored procedure nel contenitore. Per sostituire una stored procedure esistente, usare il <xref:Container.scripts.replace_stored_procedure> metodo .
create_trigger	Creare un trigger nel contenitore. Per sostituire un trigger esistente, usare il <xref:ContainerProxy.scripts.replace_trigger> metodo .
create_user_defined_function	Creare una funzione definita dall'utente nel contenitore. Per sostituire una funzione definita dall'utente esistente, usare il <xref:ContainerProxy.scripts.replace_user_defined_function> metodo .
delete_stored_procedure	Eliminare una stored procedure specificata dal contenitore. Se la stored procedure non esiste già nel contenitore, viene generata un'eccezione.
delete_trigger	Eliminare un trigger specificato dal contenitore. Se il trigger non esiste già nel contenitore, viene generata un'eccezione.
delete_user_defined_function	Eliminare una funzione definita dall'utente specificata dal contenitore. Se la funzione definita dall'utente non esiste già nel contenitore, viene generata un'eccezione.
execute_stored_procedure	Eseguire una stored procedure specificata. Se la stored procedure non esiste già nel contenitore, viene generata un'eccezione.
get_stored_procedure	Ottenere la stored procedure identificata da sproc.
get_trigger	Ottenere un trigger identificato dall'ID.
get_user_defined_function	Ottenere una funzione definita dall'utente identificata dall'ID.
list_stored_procedures	Elencare tutte le stored procedure nel contenitore.
list_triggers	Elencare tutti i trigger nel contenitore.
list_user_defined_functions	Elencare tutte le funzioni definite dall'utente nel contenitore.
query_stored_procedures	Restituisce tutte le stored procedure corrispondenti alla query specificata.
query_triggers	Restituisce tutti i trigger corrispondenti alla query specificata.
query_user_defined_functions	Restituisce funzioni definite dall'utente corrispondenti a una determinata query.
replace_stored_procedure	Sostituire una stored procedure specificata nel contenitore. Se la stored procedure non esiste già nel contenitore, viene generata un'eccezione.
replace_trigger	Sostituire un trigger specificato nel contenitore. Se il trigger non esiste già nel contenitore, viene generata un'eccezione.
replace_user_defined_function	Sostituire una funzione definita dall'utente specificata nel contenitore. Se la funzione definita dall'utente non esiste già nel contenitore, viene generata un'eccezione.

create_stored_procedure

Creare una nuova stored procedure nel contenitore.

Per sostituire una stored procedure esistente, usare il <xref:Container.scripts.replace_stored_procedure> metodo .

async create_stored_procedure(body: Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

body

Dict[str, Any]

Necessario

Oggetto simile a ct che rappresenta la stored procedure da creare.

Restituisce

Un dict che rappresenta la nuova stored procedure.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

create_trigger

Creare un trigger nel contenitore.

Per sostituire un trigger esistente, usare il <xref:ContainerProxy.scripts.replace_trigger> metodo .

async create_trigger(body: Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

body

Dict[str, Any]

Necessario

Oggetto simile a ct che rappresenta il trigger da creare.

Restituisce

Un dict che rappresenta il nuovo trigger.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare il trigger specificato.

create_user_defined_function

Creare una funzione definita dall'utente nel contenitore.

Per sostituire una funzione definita dall'utente esistente, usare il <xref:ContainerProxy.scripts.replace_user_defined_function> metodo .

async create_user_defined_function(body: Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

body

Dict[str, Any]

Necessario

Oggetto dict-like che rappresenta la funzione definita dall'utente da creare.

Restituisce

Un dict che rappresenta la nuova funzione definita dall'utente.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la funzione definita dall'utente.

delete_stored_procedure

Eliminare una stored procedure specificata dal contenitore.

Se la stored procedure non esiste già nel contenitore, viene generata un'eccezione.

async delete_stored_procedure(sproc: str | Dict[str, Any], **kwargs: Any) -> None

Parametri

sproc

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta la stored procedure da eliminare.

Tipo restituito

None

Eccezioni

CosmosHttpResponseError

La stored procedure non è stata eliminata correttamente.

CosmosResourceNotFoundError

La stored procedure non esiste nel contenitore.

delete_trigger

Eliminare un trigger specificato dal contenitore.

Se il trigger non esiste già nel contenitore, viene generata un'eccezione.

async delete_trigger(trigger: str | Dict[str, Any], **kwargs: Any) -> None

Parametri

trigger

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta il trigger da eliminare.

Tipo restituito

None

Eccezioni

CosmosHttpResponseError

Il trigger non è stato eliminato correttamente.

CosmosResourceNotFoundError

Il trigger non esiste nel contenitore.

delete_user_defined_function

Eliminare una funzione definita dall'utente specificata dal contenitore.

Se la funzione definita dall'utente non esiste già nel contenitore, viene generata un'eccezione.

async delete_user_defined_function(udf: str | Dict[str, Any], **kwargs: Any) -> None

Parametri

udf

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta udf da eliminare.

Tipo restituito

None

Eccezioni

CosmosHttpResponseError

L'utente non è stato eliminato correttamente.

CosmosResourceNotFoundError

La funzione UDF non esiste nel contenitore.

execute_stored_procedure

Eseguire una stored procedure specificata.

Se la stored procedure non esiste già nel contenitore, viene generata un'eccezione.

async execute_stored_procedure(sproc: str | Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

sproc

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta la stored procedure da eseguire.

partition_key

Union[str, int, float, bool]

Specifica la chiave di partizione per indicare la partizione in cui deve essere eseguita la stored procedure.

parameters

List[Dict[str, Any]]

Elenco di parametri da passare alla stored procedure da eseguire.

enable_script_logging

bool

Abilita o disabilita la registrazione dello script per la richiesta corrente.

Restituisce

Risultato della stored procedure eseguita per i parametri specificati.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se l'esecuzione della stored procedure non è riuscita o se la stored procedure con id specificato non esiste nel contenitore.

get_stored_procedure

Ottenere la stored procedure identificata da sproc.

async get_stored_procedure(sproc: str | Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

sproc

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta la stored procedure da recuperare.

Restituisce

Dict che rappresenta la stored procedure recuperata.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se la stored procedure specificata non è stata recuperata.

get_trigger

Ottenere un trigger identificato dall'ID.

async get_trigger(trigger: str | Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

trigger

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta il trigger da recuperare.

Restituisce

Dict che rappresenta il trigger recuperato.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile recuperare il trigger specificato.

get_user_defined_function

Ottenere una funzione definita dall'utente identificata dall'ID.

async get_user_defined_function(udf: str | Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

udf

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta udf da recuperare.

Restituisce

Un dict che rappresenta la funzione definita dall'utente recuperata.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile recuperare la funzione definita dall'utente.

list_stored_procedures

Elencare tutte le stored procedure nel contenitore.

list_stored_procedures(**kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

Parametri

max_item_count

int

Numero massimo di elementi da restituire nell'operazione di enumerazione.

Restituisce

Oggetto AsyncItemPaged di stored procedure (dict).

Tipo restituito

<xref:AsyncItemPaged>[Dict[str, Any]]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

list_triggers

Elencare tutti i trigger nel contenitore.

list_triggers(**kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

Parametri

max_item_count

int

Numero massimo di elementi da restituire nell'operazione di enumerazione.

Restituisce

AsyncItemPaged di trigger (dict).

Tipo restituito

<xref:AsyncItemPaged>[Dict[str, Any]]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

list_user_defined_functions

Elencare tutte le funzioni definite dall'utente nel contenitore.

list_user_defined_functions(**kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

Parametri

max_item_count

int

Numero massimo di elementi da restituire nell'operazione di enumerazione.

Restituisce

Oggetto AsyncItemPaged di funzioni definite dall'utente (dict).

Tipo restituito

<xref:AsyncItemPaged>[Dict[str, Any]]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

query_stored_procedures

Restituisce tutte le stored procedure corrispondenti alla query specificata.

query_stored_procedures(query: str | Dict[str, Any], **kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

Parametri

query

Union[str, Dict[str, Any]]

Necessario

Query SQL di Azure Cosmos DB da eseguire.

parameters

List[Dict[str, Any]]

Matrice facoltativa di parametri nella query. Ignorato se non viene fornita alcuna query.

max_item_count

int

Numero massimo di elementi da restituire nell'operazione di enumerazione.

Restituisce

Oggetto AsyncItemPaged di stored procedure (dict).

Tipo restituito

<xref:AsyncItemPaged>[Dict[str, Any]]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

query_triggers

Restituisce tutti i trigger corrispondenti alla query specificata.

query_triggers(query: str | Dict[str, Any], **kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

Parametri

query

Union[str, Dict[str, Any]]

Necessario

Query SQL di Azure Cosmos DB da eseguire.

parameters

List[Dict[str, Any]]

Matrice facoltativa di parametri nella query. Ignorato se non viene fornita alcuna query.

max_item_count

int

Numero massimo di elementi da restituire nell'operazione di enumerazione.

Restituisce

AsyncItemPaged di trigger (dict).

Tipo restituito

<xref:AsyncItemPaged>[Dict[str, Any]]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

query_user_defined_functions

Restituisce funzioni definite dall'utente corrispondenti a una determinata query.

query_user_defined_functions(query: str | Dict[str, Any], **kwargs: Any) -> AsyncItemPaged[Dict[str, Any]]

Parametri

query

Union[str, Dict[str, Any]]

Necessario

Query SQL di Azure Cosmos DB da eseguire.

parameters

List[Dict[str, Any]]

Matrice facoltativa di parametri nella query. Ignorato se non viene fornita alcuna query.

max_item_count

int

Numero massimo di elementi da restituire nell'operazione di enumerazione.

Restituisce

Oggetto AsyncItemPaged di funzioni definite dall'utente (dict).

Tipo restituito

<xref:AsyncItemPaged>[Dict[str, Any]]

Eccezioni

CosmosHttpResponseError

Se non è stato possibile creare la stored procedure specificata.

replace_stored_procedure

Sostituire una stored procedure specificata nel contenitore.

Se la stored procedure non esiste già nel contenitore, viene generata un'eccezione.

async replace_stored_procedure(sproc: str | Dict[str, Any], body: Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

sproc

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta la stored procedure da sostituire.

body

Dict[str, Any]

Necessario

Oggetto dict-like che rappresenta la stored procedure da sostituire.

Restituisce

Un dict che rappresenta la stored procedure dopo aver eseguito la sostituzione.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se la sostituzione non è riuscita o la stored procedure con id specificato non esiste.

replace_trigger

Sostituire un trigger specificato nel contenitore.

Se il trigger non esiste già nel contenitore, viene generata un'eccezione.

async replace_trigger(trigger: str | Dict[str, Any], body: Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

trigger

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta il trigger da sostituire.

body

Dict[str, Any]

Necessario

Oggetto simile a ct che rappresenta il trigger da sostituire.

Restituisce

Un dict che rappresenta il trigger dopo aver eseguito la sostituzione.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se la sostituzione non è riuscita o il trigger con id specificato non esiste.

replace_user_defined_function

Sostituire una funzione definita dall'utente specificata nel contenitore.

Se la funzione definita dall'utente non esiste già nel contenitore, viene generata un'eccezione.

async replace_user_defined_function(udf: str | Dict[str, Any], body: Dict[str, Any], **kwargs: Any) -> Dict[str, Any]

Parametri

udf

Union[str, Dict[str, Any]]

Necessario

ID (nome) o dict che rappresenta la funzione definita dall'utente da sostituire.

body

Dict[str, Any]

Necessario

Oggetto simile a ct che rappresenta la funzione udf da sostituire.

Restituisce

Un dict che rappresenta la funzione definita dall'utente dopo aver eseguito la sostituzione.

Tipo restituito

Dict[str, Any]

Eccezioni

CosmosHttpResponseError

Se la sostituzione non è riuscita o la funzione definita dall'utente con l'ID specificato non esiste.