ScriptsProxy 類別

與預存程式互動的介面。

此類別不應直接具現化。 請改用 scripts 屬性。

繼承

builtins.object

ScriptsProxy

建構函式

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

參數

container

client_connection

container_link

方法

create_stored_procedure	在容器中建立新的預存程式。 若要取代現有的預存程式，請使用 <xref:Container.scripts.replace_stored_procedure> 方法。
create_trigger	在容器中建立觸發程式。 若要取代現有的觸發程式，請使用 <xref:ContainerProxy.scripts.replace_trigger> 方法。
create_user_defined_function	在容器中建立使用者定義的函式。 若要取代現有的使用者定義函式，請使用 <xref:ContainerProxy.scripts.replace_user_defined_function> 方法。
delete_stored_procedure	從容器中刪除指定的預存程式。 如果預存程式不存在於容器中，則會引發例外狀況。
delete_trigger	從容器中刪除指定的觸發程式。 如果容器中還沒有觸發程式，就會引發例外狀況。
delete_user_defined_function	從容器中刪除指定的使用者定義函式。 如果容器中還沒有任何使用者定義函式存在，就會引發例外狀況。
execute_stored_procedure	執行指定的預存程式。 如果預存程式不存在於容器中，則會引發例外狀況。
get_stored_procedure	取得 sproc所識別的預存程式。
get_trigger	取得 識別碼所識別的觸發程式。
get_user_defined_function	取得以 識別碼識別的使用者定義函式。
list_stored_procedures	列出容器中的所有預存程式。
list_triggers	列出容器中的所有觸發程式。
list_user_defined_functions	列出容器中的所有使用者定義函式。
query_stored_procedures	傳回符合指定 查詢的所有預存程式。
query_triggers	傳回符合指定 查詢的所有觸發程式。
query_user_defined_functions	傳回符合指定 查詢的使用者定義函式。
replace_stored_procedure	取代容器中的指定預存程式。 如果預存程式不存在於容器中，則會引發例外狀況。
replace_trigger	取代容器中的指定觸發程式。 如果容器中還沒有觸發程式，就會引發例外狀況。
replace_user_defined_function	取代容器中的指定使用者定義函式。 如果容器中還沒有任何使用者定義函式存在，就會引發例外狀況。

create_stored_procedure

在容器中建立新的預存程式。

若要取代現有的預存程式，請使用 <xref:Container.scripts.replace_stored_procedure> 方法。

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

參數

body

Dict[str, Any]

必要

類似聽寫的物件，表示要建立的預存程式。

傳回

表示新預存程式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

create_trigger

在容器中建立觸發程式。

若要取代現有的觸發程式，請使用 <xref:ContainerProxy.scripts.replace_trigger> 方法。

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

參數

body

Dict[str, Any]

必要

類似聽寫的物件，表示要建立的觸發程式。

傳回

表示新觸發程式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果無法建立指定的觸發程式。

create_user_defined_function

在容器中建立使用者定義的函式。

若要取代現有的使用者定義函式，請使用 <xref:ContainerProxy.scripts.replace_user_defined_function> 方法。

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

參數

body

Dict[str, Any]

必要

類似聽寫的物件，表示要建立的使用者定義函式。

傳回

表示新使用者定義函式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果無法建立使用者定義的函式。

delete_stored_procedure

從容器中刪除指定的預存程式。

如果預存程式不存在於容器中，則會引發例外狀況。

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

參數

sproc

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或聽寫，代表要刪除的預存程式。

傳回類型

None

例外狀況

CosmosHttpResponseError

預存程式未成功刪除。

CosmosResourceNotFoundError

預存程式不存在於容器中。

delete_trigger

從容器中刪除指定的觸發程式。

如果容器中還沒有觸發程式，就會引發例外狀況。

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

參數

trigger

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或聽寫，代表要刪除的觸發程式。

傳回類型

None

例外狀況

CosmosHttpResponseError

觸發程式未成功刪除。

CosmosResourceNotFoundError

觸發程式不存在於容器中。

delete_user_defined_function

從容器中刪除指定的使用者定義函式。

如果容器中還沒有任何使用者定義函式存在，就會引發例外狀況。

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

參數

udf

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或表示要刪除之 udf 的聽寫。

傳回類型

None

例外狀況

CosmosHttpResponseError

udf 未成功刪除。

CosmosResourceNotFoundError

UDF 不存在於容器中。

execute_stored_procedure

執行指定的預存程式。

如果預存程式不存在於容器中，則會引發例外狀況。

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

參數

sproc

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或聽寫，代表要執行的預存程式。

partition_key

Union[str, int, float, bool]

指定分割區索引鍵，指出預存程式應該執行的分割區。

parameters

List[Dict[str, Any]]

要傳遞至要執行之預存程式的參數清單。

enable_script_logging

bool

啟用或停用目前要求的腳本記錄。

傳回

指定參數的執行預存程式結果。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果預存程式執行失敗，或具有指定識別碼的預存程式不存在於容器中。

get_stored_procedure

取得 sproc所識別的預存程式。

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

參數

sproc

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或聽寫，代表要擷取的預存程式。

傳回

表示所擷取預存程式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果無法擷取指定的預存程式。

get_trigger

取得 識別碼所識別的觸發程式。

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

參數

trigger

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或表示要擷取之觸發程式的聽寫。

傳回

表示所擷取觸發程式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果無法擷取指定的觸發程式。

get_user_defined_function

取得以 識別碼識別的使用者定義函式。

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

參數

udf

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或表示要擷取之 udf 的聽寫。

傳回

表示所擷取使用者定義函式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果無法擷取使用者定義的函式。

list_stored_procedures

列出容器中的所有預存程式。

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

參數

max_item_count

int

列舉作業中要傳回的專案數目上限。

傳回

預存程式的 AsyncItemPaged (聽寫) 。

傳回類型

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

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

list_triggers

列出容器中的所有觸發程式。

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

參數

max_item_count

int

列舉作業中要傳回的專案數目上限。

傳回

觸發程式的 AsyncItemPaged (聽寫) 。

傳回類型

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

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

list_user_defined_functions

列出容器中的所有使用者定義函式。

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

參數

max_item_count

int

列舉作業中要傳回的專案數目上限。

傳回

使用者定義函式的 AsyncItemPaged (聽寫) 。

傳回類型

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

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

query_stored_procedures

傳回符合指定 查詢的所有預存程式。

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

參數

query

Union[str, Dict[str, Any]]

必要

要執行的 Azure Cosmos DB SQL 查詢。

parameters

List[Dict[str, Any]]

查詢的參數選擇性陣列。 如果未提供任何查詢，則會忽略。

max_item_count

int

列舉作業中要傳回的專案數目上限。

傳回

預存程式的 AsyncItemPaged (聽寫) 。

傳回類型

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

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

query_triggers

傳回符合指定 查詢的所有觸發程式。

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

參數

query

Union[str, Dict[str, Any]]

必要

要執行的 Azure Cosmos DB SQL 查詢。

parameters

List[Dict[str, Any]]

查詢的參數選擇性陣列。 如果未提供任何查詢，則會忽略。

max_item_count

int

列舉作業中要傳回的專案數目上限。

傳回

觸發程式的 AsyncItemPaged (聽寫) 。

傳回類型

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

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

query_user_defined_functions

傳回符合指定 查詢的使用者定義函式。

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

參數

query

Union[str, Dict[str, Any]]

必要

要執行的 Azure Cosmos DB SQL 查詢。

parameters

List[Dict[str, Any]]

查詢的參數選擇性陣列。 如果未提供任何查詢，則會忽略。

max_item_count

int

列舉作業中要傳回的專案數目上限。

傳回

使用者定義函式的 AsyncItemPaged (聽寫) 。

傳回類型

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

例外狀況

CosmosHttpResponseError

如果無法建立指定的預存程式。

replace_stored_procedure

取代容器中的指定預存程式。

如果預存程式不存在於容器中，則會引發例外狀況。

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

參數

sproc

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或聽寫，代表要取代的預存程式。

body

Dict[str, Any]

必要

類似聽寫的物件，表示要取代的預存程式。

傳回

表示取代之後預存程式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果取代失敗，或具有指定識別碼的預存程式不存在。

replace_trigger

取代容器中的指定觸發程式。

如果容器中還沒有觸發程式，就會引發例外狀況。

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

參數

trigger

Union[str, Dict[str, Any]]

必要

識別碼 (名稱) 或聽寫，代表要取代的觸發程式。

body

Dict[str, Any]

必要

類似聽寫的物件，表示要取代的觸發程式。

傳回

表示取代之後觸發程式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果取代失敗，或具有指定識別碼的觸發程式不存在。

replace_user_defined_function

取代容器中的指定使用者定義函式。

如果容器中還沒有任何使用者定義函式存在，就會引發例外狀況。

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

參數

udf

Union[str, Dict[str, Any]]

必要

要取代之使用者定義函數的識別碼 (名稱) 或聽寫。

body

Dict[str, Any]

必要

類似聽寫的物件，代表要取代的 udf。

傳回

表示取代之後使用者定義函式的聽寫。

傳回類型

Dict[str, Any]

例外狀況

CosmosHttpResponseError

如果取代失敗，或具有指定識別碼的使用者定義函式不存在。