ScriptsProxy Classe

Interface permettant d’interagir avec les procédures stockées.

Cette classe ne doit pas être instanciée directement. Utilisez plutôt l’attribut scripts .

Héritage

builtins.object

ScriptsProxy

Constructeur

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

Paramètres

container

client_connection

container_link

Méthodes

create_stored_procedure	Créez une procédure stockée dans le conteneur. Pour remplacer une procédure stockée existante, utilisez la <xref:Container.scripts.replace_stored_procedure> méthode .
create_trigger	Créez un déclencheur dans le conteneur. Pour remplacer un déclencheur existant, utilisez la <xref:ContainerProxy.scripts.replace_trigger> méthode .
create_user_defined_function	Créez une fonction définie par l’utilisateur dans le conteneur. Pour remplacer une fonction existante définie par l’utilisateur, utilisez la <xref:ContainerProxy.scripts.replace_user_defined_function> méthode .
delete_stored_procedure	Supprimez une procédure stockée spécifiée du conteneur. Si la procédure stockée n’existe pas encore dans le conteneur, une exception est levée.
delete_trigger	Supprimez un déclencheur spécifié du conteneur. Si le déclencheur n’existe pas encore dans le conteneur, une exception est levée.
delete_user_defined_function	Supprime une fonction définie par l’utilisateur spécifiée du conteneur. Si la fonction définie par l’utilisateur n’existe pas encore dans le conteneur, une exception est levée.
execute_stored_procedure	Exécutez une procédure stockée spécifiée. Si la procédure stockée n’existe pas encore dans le conteneur, une exception est levée.
get_stored_procedure	Obtenez la procédure stockée identifiée par sproc.
get_trigger	Obtenez un déclencheur identifié par id.
get_user_defined_function	Obtenez une fonction définie par l’utilisateur identifiée par id.
list_stored_procedures	Répertoriez toutes les procédures stockées dans le conteneur.
list_triggers	Répertoriez tous les déclencheurs dans le conteneur.
list_user_defined_functions	Répertorie toutes les fonctions définies par l’utilisateur dans le conteneur.
query_stored_procedures	Retourne toutes les procédures stockées correspondant à la requête donnée.
query_triggers	Retourne tous les déclencheurs correspondant à la requête donnée.
query_user_defined_functions	Retourne des fonctions définies par l’utilisateur correspondant à une requête donnée.
replace_stored_procedure	Remplacez une procédure stockée spécifiée dans le conteneur. Si la procédure stockée n’existe pas encore dans le conteneur, une exception est levée.
replace_trigger	Remplacez un déclencheur spécifié dans le conteneur. Si le déclencheur n’existe pas encore dans le conteneur, une exception est levée.
replace_user_defined_function	Remplacez une fonction définie par l’utilisateur spécifiée dans le conteneur. Si la fonction définie par l’utilisateur n’existe pas encore dans le conteneur, une exception est levée.

create_stored_procedure

Créez une procédure stockée dans le conteneur.

Pour remplacer une procédure stockée existante, utilisez la <xref:Container.scripts.replace_stored_procedure> méthode .

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

Paramètres

body

Dict[str, Any]

Obligatoire

Objet de type dict représentant la procédure stockée à créer.

Retours

dict représentant la nouvelle procédure stockée.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

create_trigger

Créez un déclencheur dans le conteneur.

Pour remplacer un déclencheur existant, utilisez la <xref:ContainerProxy.scripts.replace_trigger> méthode .

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

Paramètres

body

Dict[str, Any]

Obligatoire

Objet de type dict représentant le déclencheur à créer.

Retours

dict représentant le nouveau déclencheur.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si le déclencheur donné n’a pas pu être créé.

create_user_defined_function

Créez une fonction définie par l’utilisateur dans le conteneur.

Pour remplacer une fonction existante définie par l’utilisateur, utilisez la <xref:ContainerProxy.scripts.replace_user_defined_function> méthode .

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

Paramètres

body

Dict[str, Any]

Obligatoire

Objet de type dict représentant la fonction définie par l’utilisateur à créer.

Retours

dict représentant la nouvelle fonction définie par l’utilisateur.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si la fonction définie par l’utilisateur n’a pas pu être créée.

delete_stored_procedure

Supprimez une procédure stockée spécifiée du conteneur.

Si la procédure stockée n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

sproc

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant la procédure stockée à supprimer.

Type de retour

None

Exceptions

CosmosHttpResponseError

La procédure stockée n’a pas été supprimée avec succès.

CosmosResourceNotFoundError

La procédure stockée n’existe pas dans le conteneur.

delete_trigger

Supprimez un déclencheur spécifié du conteneur.

Si le déclencheur n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

trigger

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant le déclencheur à supprimer.

Type de retour

None

Exceptions

CosmosHttpResponseError

Le déclencheur n’a pas été supprimé avec succès.

CosmosResourceNotFoundError

Le déclencheur n’existe pas dans le conteneur.

delete_user_defined_function

Supprime une fonction définie par l’utilisateur spécifiée du conteneur.

Si la fonction définie par l’utilisateur n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

udf

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant udf à supprimer.

Type de retour

None

Exceptions

CosmosHttpResponseError

L’udf n’a pas été supprimé avec succès.

CosmosResourceNotFoundError

La fonction UDF n’existe pas dans le conteneur.

execute_stored_procedure

Exécutez une procédure stockée spécifiée.

Si la procédure stockée n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

sproc

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant la procédure stockée à exécuter.

partition_key

Union[str, int, float, bool]

Spécifie la clé de partition pour indiquer la partition sur laquelle la procédure stockée doit s’exécuter.

parameters

List[Dict[str, Any]]

Liste des paramètres à passer à la procédure stockée à exécuter.

enable_script_logging

bool

Active ou désactive la journalisation des scripts pour la requête actuelle.

Retours

Résultat de la procédure stockée exécutée pour les paramètres donnés.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si l’exécution de la procédure stockée a échoué ou si la procédure stockée avec l’ID donné n’existe pas dans le conteneur.

get_stored_procedure

Obtenez la procédure stockée identifiée par sproc.

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

Paramètres

sproc

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant la procédure stockée à récupérer.

Retours

dict représentant la procédure stockée récupérée.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être récupérée.

get_trigger

Obtenez un déclencheur identifié par id.

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

Paramètres

trigger

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant le déclencheur à récupérer.

Retours

dict représentant le déclencheur récupéré.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si le déclencheur donné n’a pas pu être récupéré.

get_user_defined_function

Obtenez une fonction définie par l’utilisateur identifiée par id.

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

Paramètres

udf

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant udf à récupérer.

Retours

dict représentant la fonction définie par l’utilisateur récupérée.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si la fonction définie par l’utilisateur n’a pas pu être récupérée.

list_stored_procedures

Répertoriez toutes les procédures stockées dans le conteneur.

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

Paramètres

max_item_count

int

Nombre maximal d’éléments à retourner dans l’opération d’énumération.

Retours

AsyncItemPaged de procédures stockées (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

list_triggers

Répertoriez tous les déclencheurs dans le conteneur.

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

Paramètres

max_item_count

int

Nombre maximal d’éléments à retourner dans l’opération d’énumération.

Retours

AsyncItemPaged de déclencheurs (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

list_user_defined_functions

Répertorie toutes les fonctions définies par l’utilisateur dans le conteneur.

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

Paramètres

max_item_count

int

Nombre maximal d’éléments à retourner dans l’opération d’énumération.

Retours

AsyncItemPaged de fonctions définies par l’utilisateur (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

query_stored_procedures

Retourne toutes les procédures stockées correspondant à la requête donnée.

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

Paramètres

query

Union[str, Dict[str, Any]]

Obligatoire

Requête SQL Azure Cosmos DB à exécuter.

parameters

List[Dict[str, Any]]

Tableau facultatif de paramètres de la requête. Ignoré si aucune requête n’est fournie.

max_item_count

int

Nombre maximal d’éléments à retourner dans l’opération d’énumération.

Retours

AsyncItemPaged de procédures stockées (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

query_triggers

Retourne tous les déclencheurs correspondant à la requête donnée.

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

Paramètres

query

Union[str, Dict[str, Any]]

Obligatoire

Requête SQL Azure Cosmos DB à exécuter.

parameters

List[Dict[str, Any]]

Tableau facultatif de paramètres de la requête. Ignoré si aucune requête n’est fournie.

max_item_count

int

Nombre maximal d’éléments à retourner dans l’opération d’énumération.

Retours

AsyncItemPaged de déclencheurs (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

query_user_defined_functions

Retourne des fonctions définies par l’utilisateur correspondant à une requête donnée.

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

Paramètres

query

Union[str, Dict[str, Any]]

Obligatoire

Requête SQL Azure Cosmos DB à exécuter.

parameters

List[Dict[str, Any]]

Tableau facultatif de paramètres de la requête. Ignoré si aucune requête n’est fournie.

max_item_count

int

Nombre maximal d’éléments à retourner dans l’opération d’énumération.

Retours

AsyncItemPaged de fonctions définies par l’utilisateur (dicts).

Type de retour

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

Exceptions

CosmosHttpResponseError

Si la procédure stockée donnée n’a pas pu être créée.

replace_stored_procedure

Remplacez une procédure stockée spécifiée dans le conteneur.

Si la procédure stockée n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

sproc

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant la procédure stockée à remplacer.

body

Dict[str, Any]

Obligatoire

Objet de type dict représentant la procédure stockée à remplacer.

Retours

dict représentant la procédure stockée après l’opération de remplacement.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si le remplacement a échoué ou si la procédure stockée avec un ID donné n’existe pas.

replace_trigger

Remplacez un déclencheur spécifié dans le conteneur.

Si le déclencheur n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

trigger

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant le déclencheur à remplacer.

body

Dict[str, Any]

Obligatoire

Objet de type dict représentant le déclencheur à remplacer.

Retours

dict représentant le déclencheur après le remplacement.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si le remplacement a échoué ou si le déclencheur avec l’ID donné n’existe pas.

replace_user_defined_function

Remplacez une fonction définie par l’utilisateur spécifiée dans le conteneur.

Si la fonction définie par l’utilisateur n’existe pas encore dans le conteneur, une exception est levée.

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

Paramètres

udf

Union[str, Dict[str, Any]]

Obligatoire

ID (nom) ou dict représentant la fonction définie par l’utilisateur à remplacer.

body

Dict[str, Any]

Obligatoire

Objet de type dict représentant l’udf à remplacer.

Retours

dict représentant la fonction définie par l’utilisateur après l’opération de remplacement.

Type de retour

Dict[str, Any]

Exceptions

CosmosHttpResponseError

Si le remplacement a échoué ou si la fonction définie par l’utilisateur avec l’ID donné n’existe pas.