Merge pull request #231113 from seesharprun/cosmos-how-to-use-stored-procedures-triggers-udfs-code-review

Cosmos DB | Add note about client objects to NoSQL server-side programming

Author: prmerger-automator[bot]

articles/cosmos-db/nosql/how-to-use-stored-procedures-triggers-udfs.md

@@ -1,18 +1,20 @@
 ---
-title: Register and use stored procedures, triggers, and user-defined functions in Azure Cosmos DB SDKs
+title: Use stored procedures, triggers, and UDFs in SDKs
+titleSuffix: Azure Cosmos DB
 description: Learn how to register and call stored procedures, triggers, and user-defined functions using the Azure Cosmos DB SDKs.
 author: seesharprun
 ms.service: cosmos-db
 ms.subservice: nosql
-ms.topic: how-to
-ms.date: 03/09/2023
+ms.topic: conceptual
+ms.date: 03/16/2023
 ms.author: sidandrews
 ms.reviewer: jucocchi
 ms.devlang: csharp, java, javascript, python
 ms.custom: devx-track-python, devx-track-js, devx-track-csharp
 ---
 
 # How to register and use stored procedures, triggers, and user-defined functions in Azure Cosmos DB
+
 [!INCLUDE[NoSQL](../includes/appliesto-nosql.md)]
 
 The API for NoSQL in Azure Cosmos DB supports registering and invoking stored procedures, triggers, and user-defined functions (UDFs) written in JavaScript. After you define one or more stored procedures, triggers, or user-defined functions, you can load and view them in the [Azure portal](https://portal.azure.com/) by using Data Explorer.
@@ -22,10 +24,13 @@ You can use the API for NoSQL SDK across multiple platforms including [.NET v2 (
 | SDK | Getting started |
 | :--- | :--- |
 | .NET v3 | [Quickstart: Azure Cosmos DB for NoSQL client library for .NET](quickstart-dotnet.md) |
-| Java | [Quickstart: Build a Java app to manage Azure Cosmos DB for NoSQL data](quickstart-java.md)
+| Java | [Quickstart: Build a Java app to manage Azure Cosmos DB for NoSQL data](quickstart-java.md) |
 | JavaScript | [Quickstart: Azure Cosmos DB for NoSQL client library for Node.js](quickstart-nodejs.md) |
 | Python | [Quickstart: Azure Cosmos DB for NoSQL client library for Python](quickstart-python.md) |
 
+> [!IMPORTANT]
+> The following code samples assume that you have already have `client` and `container` variables. If you need to create those variables, refer to the appropriate quickstart for your platform.
+
 ## How to run stored procedures
 
 Stored procedures are written using JavaScript. They can create, update, read, query, and delete items within an Azure Cosmos DB container. For more information, see [How to write stored procedures](how-to-write-stored-procedures-triggers-udfs.md#stored-procedures).
@@ -232,18 +237,18 @@ result = container.scripts.execute_stored_procedure(sproc=created_sproc,params=[
 
 ---
 
-## How to run pre-triggers
+## <a id="how-to-run-pre-triggers"></a>How to run pretriggers
 
-The following examples show how to register and call a pre-trigger by using the Azure Cosmos DB SDKs. For the source of this pre-trigger example, saved as *trgPreValidateToDoItemTimestamp.js*, see [Pre-triggers](how-to-write-stored-procedures-triggers-udfs.md#pre-triggers).
+The following examples show how to register and call a pretrigger by using the Azure Cosmos DB SDKs. For the source of this pretrigger example, saved as *trgPreValidateToDoItemTimestamp.js*, see [Pretriggers](how-to-write-stored-procedures-triggers-udfs.md#pre-triggers).
 
-When you run an operation by specifying `PreTriggerInclude` and then passing the name of the trigger in a `List` object, pre-triggers are passed in the `RequestOptions` object.
+When you run an operation by specifying `PreTriggerInclude` and then passing the name of the trigger in a `List` object, pretriggers are passed in the `RequestOptions` object.
 
 > [!NOTE]
 > Even though the name of the trigger is passed as a `List`, you can still run only one trigger per operation.
 
 ### [.NET SDK v2](#tab/dotnet-sdk-v2)
 
-The following code shows how to register a pre-trigger using the .NET SDK v2:
+The following code shows how to register a pretrigger using the .NET SDK v2:
 
 ```csharp
 string triggerId = "trgPreValidateToDoItemTimestamp";
@@ -258,7 +263,7 @@ Uri containerUri = UriFactory.CreateDocumentCollectionUri("myDatabase", "myConta
 await client.CreateTriggerAsync(containerUri, trigger);
 ```
 
-The following code shows how to call a pre-trigger using the .NET SDK v2:
+The following code shows how to call a pretrigger using the .NET SDK v2:
 
 ```csharp
 dynamic newItem = new
@@ -276,7 +281,7 @@ await client.CreateDocumentAsync(containerUri, newItem, requestOptions);
 
 ### [.NET SDK v3](#tab/dotnet-sdk-v3)
 
-The following code shows how to register a pre-trigger using the .NET SDK v3:
+The following code shows how to register a pretrigger using the .NET SDK v3:
 
 ```csharp
 await client.GetContainer("database", "container").Scripts.CreateTriggerAsync(new TriggerProperties
@@ -288,7 +293,7 @@ await client.GetContainer("database", "container").Scripts.CreateTriggerAsync(ne
 });
 ```
 
-The following code shows how to call a pre-trigger using the .NET SDK v3:
+The following code shows how to call a pretrigger using the .NET SDK v3:
 
 ```csharp
 dynamic newItem = new
@@ -304,7 +309,7 @@ await client.GetContainer("database", "container").CreateItemAsync(newItem, null
 
 ### [Java SDK](#tab/java-sdk)
 
-The following code shows how to register a pre-trigger using the Java SDK:
+The following code shows how to register a pretrigger using the Java SDK:
 
 ```java
 CosmosTriggerProperties definition = new CosmosTriggerProperties(
@@ -319,7 +324,7 @@ CosmosTriggerResponse response = container
     .createTrigger(definition);
 ```
 
-The following code shows how to call a pre-trigger using the Java SDK:
+The following code shows how to call a pretrigger using the Java SDK:
 
 ```java
 ToDoItem item = new ToDoItem();
@@ -338,7 +343,7 @@ CosmosItemResponse<ToDoItem> response = container.createItem(item, options);
 
 ### [JavaScript SDK](#tab/javascript-sdk)
 
-The following code shows how to register a pre-trigger using the JavaScript SDK:
+The following code shows how to register a pretrigger using the JavaScript SDK:
 
 ```javascript
 const container = client.database("myDatabase").container("myContainer");
@@ -351,7 +356,7 @@ await container.scripts.triggers.create({
 });
 ```
 
-The following code shows how to call a pre-trigger using the JavaScript SDK:
+The following code shows how to call a pretrigger using the JavaScript SDK:
 
 ```javascript
 const container = client.database("myDatabase").container("myContainer");
@@ -366,7 +371,7 @@ await container.items.create({
 
 ### [Python SDK](#tab/python-sdk)
 
-The following code shows how to register a pre-trigger using the Python SDK:
+The following code shows how to register a pretrigger using the Python SDK:
 
 ```python
 import azure.cosmos.cosmos_client as cosmos_client
@@ -392,7 +397,7 @@ container = database.get_container_client(container_name)
 trigger = container.scripts.create_trigger(trigger_definition)
 ```
 
-The following code shows how to call a pre-trigger using the Python SDK:
+The following code shows how to call a pretrigger using the Python SDK:
 
 ```python
 item = {'category': 'Personal', 'name': 'Groceries',