Integración de Azure Cosmos DB for NoSQL con Service Connector

En esta página se muestran los métodos de autenticación admitidos y los clientes, y se muestra el código de ejemplo que puede usar para conectar Azure Cosmos DB para NoSQL a otros servicios en la nube mediante Service Conectar or. Es posible que todavía pueda conectarse a Azure Cosmos DB para NoSQL en otros lenguajes de programación sin usar Service Conectar or. Esta página también muestra los nombres y valores predeterminados de las variables de entorno o la configuración de Spring Boot que se obtiene al crear la conexión de servicio.

Servicios de proceso admitidos

Service Conectar or se puede usar para conectar los siguientes servicios de proceso a Azure Cosmos DB para NoSQL:

• Azure App Service
• Azure Functions
• Azure Container Apps
• Azure Spring Apps

Tipos de autenticación y tipos de cliente admitidos

En la tabla siguiente se muestran las combinaciones de tipos de cliente y métodos de autenticación que se admiten para conectar el servicio de proceso a Azure Cosmos DB para NoSQL mediante Service Conectar or. Un valor "Sí" indica que se admite la combinación, mientras que "No" indica que no se admite.

Tipo de cliente	Identidad administrada asignada por el sistema	Identidad administrada asignada por el usuario	Secreto/cadena de conexión	Entidad de servicio
.NET	Sí	Sí	Sí	Sí
Java	Sí	Sí	Sí	Sí
Java: Spring Boot	Sí	Sí	Sí	Sí
Node.js	Sí	Sí	Sí	Sí
Python	Sí	Sí	Sí	Sí
Go	Sí	Sí	Sí	Sí
None	Sí	Sí	Sí	Sí

Esta tabla indica que se admiten todas las combinaciones de tipos de cliente y métodos de autenticación de la tabla. Todos los tipos de cliente pueden usar cualquiera de los métodos de autenticación para conectarse a Azure Cosmos DB para NoSQL mediante service Conectar or.

Nombres de variables de entorno predeterminados o propiedades de aplicación y código de ejemplo

Use los detalles de conexión siguientes para conectar los servicios de proceso a Azure Cosmos DB for NoSQL. Para cada ejemplo siguiente, sustituya los textos del marcador de posición <database-server>, <database-name>, <account-key>, <resource-group-name>, <subscription-ID>, <client-ID>, <SQL-server>, <client-secret>, <tenant-id> y <access-key> por su propia información. Para obtener más información sobre las convenciones de nomenclatura, consulte el artículo Service Conectar or internals (Interno de service Conectar).

Identidad administrada asignada por el sistema

Tipo de cliente SpringBoot

El uso de una identidad administrada asignada por el sistema como tipo de autenticación solo está disponible para Spring Cloud Azure versión 4.0 o posterior.

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
spring.cloud.azure.cosmos.credential.managed-identity-enabled	Si se va a habilitar la identidad administrada	true
spring.cloud.azure.cosmos.database	Su base de datos	https://management.azure.com/.default
spring.cloud.azure.cosmos.endpoint	Punto de conexión del recurso	https://<database-server>.documents.azure.com:443/

Otros tipos de cliente

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_COSMOS_LISTCONNECTIONSTRINGURL	Dirección URL para obtener la cadena de conexión	https://management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/databaseAccounts/<database-server>/listConnectionStrings?api-version=2021-04-15
AZURE_COSMOS_SCOPE	Ámbito de la identidad administrada	https://management.azure.com/.default
AZURE_COSMOS_RESOURCEENDPOINT	Punto de conexión del recurso	https://<database-server>.documents.azure.com:443/

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure Cosmos DB para NoSQL mediante una identidad asignada por el sistema.

.NET

1. Instale las dependencias.

   dotnet add package Microsoft.Azure.Cosmos
   dotnet add package Azure.Identity
   

2. Autentíquese mediante Azure.Identity el paquete NuGet y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   using Microsoft.Azure.Cosmos;
   using Azure.Core;
   using Azure.Identity;
   using System; 
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned identity.
   // TokenCredential credential = new DefaultAzureCredential();
   
   // For user-assigned identity.
   // TokenCredential credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTID");
   //     }
   // );
   
   // For service principal.
   // TokenCredential credential = new ClientSecretCredential(
   //     tenantId: Environment.GetEnvironmentVariable("AZURE_COSMOS_TENANTID")!,
   //     clientId: Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTID")!,
   //     clientSecret: Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTSECRET")!,
   //     options: new TokenCredentialOptions()
   // );
   
   // Create a new instance of CosmosClient using the credential above
   using CosmosClient client = new(
       accountEndpoint: Environment.GetEnvironmentVariable("AZURE_COSMOS_RESOURCEENDPOINT")!,
       tokenCredential: credential
   );
   

Java

1. Agregue las siguientes dependencias al archivo pom.xml:

   <dependency>
   	<groupId>com.azure</groupId>
   	<artifactId>azure-cosmos</artifactId>
   	<version>LATEST</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.1.5</version>
   </dependency>
   

2. Autentíquese a través azure-identity de y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import com.azure.cosmos.CosmosClient;
   import com.azure.cosmos.CosmosClientBuilder;
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_COSMOS_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("<AZURE_COSMOS_CLIENTID>"))
   //   .clientSecret(System.getenv("<AZURE_COSMOS_CLIENTSECRET>"))
   //   .tenantId(System.getenv("<AZURE_COSMOS_TENANTID>"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_COSMOS_RESOURCEENDPOINT");
   
   CosmosClient cosmosClient = new CosmosClientBuilder()
       .endpoint(endpoint)
       .credential(credential)
       .buildClient();
   

SpringBoot

Consulte Compilación de una aplicación de Spring Data Azure Cosmos DB v3 para administrar datos de Azure Cosmos DB para NoSQL para configurar la aplicación Spring. Service Conectar or agrega las propiedades de configuración a Spring Apps. La compatibilidad con identidades administradas para Cosmos DB solo está disponible para Spring Cloud Versión 4.0 y posteriores. Para más información, consulte La documentación de referencia de Spring Cloud Azure.

Python

1. Instale las dependencias.

   pip install azure-identity
   pip install azure-cosmos
   

2. Autentíquese a través azure-identity de la biblioteca y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import os
   from azure.cosmos import CosmosClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines according to the authentication type.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_COSMOS_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_COSMOS_TENANTID')
   # client_id = os.getenv('AZURE_COSMOS_CLIENTID')
   # client_secret = os.getenv('AZURE_COSMOS_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   endpoint = os.environ["AZURE_COSMOS_RESOURCEENDPOINT"]
   client = CosmosClient(url=endpoint, credential=cred)
   
   

Go

1. Instale las dependencias.

   go get t github.com/Azure/azure-sdk-for-go/sdk/azidentity
   go get github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos
   

2. Autentíquese mediante azidentity el paquete npm y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import (
       "os"
   
       "github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos"
       "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   )
   
   func main() {
       endpoint = os.Getenv("AZURE_COSMOS_RESOURCEENDPOINT")
   
       // Uncomment the following lines according to the authentication type.
       // For system-assigned identity.
       // cred, err := azidentity.NewDefaultAzureCredential(nil)
   
       // For user-assigned identity.
       // clientid := os.Getenv("AZURE_COSMOS_CLIENTID")
       // azidentity.ManagedIdentityCredentialOptions.ID := clientid
       // options := &azidentity.ManagedIdentityCredentialOptions{ID: clientid}
       // cred, err := azidentity.NewManagedIdentityCredential(options)
   
       // For service principal.
       // clientid := os.Getenv("AZURE_COSMOS_CLIENTID")
       // tenantid := os.Getenv("AZURE_COSMOS_TENANTID")
       // clientsecret := os.Getenv("AZURE_COSMOS_CLIENTSECRET")
       // cred, err := azidentity.NewClientSecretCredential(tenantid, clientid, clientsecret, &azidentity.ClientSecretCredentialOptions{})
   
       client, err := azcosmos.NewClient(endpoint, cred, nil)
   }
   

NodeJS

1. Instale las dependencias.

   npm install @azure/identity
   npm install @azure/cosmos
   

2. Autentíquese mediante @azure/identity el paquete npm y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import { CosmosClient } from "@azure/cosmos";
   const { DefaultAzureCredential } = require("@azure/identity");
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned managed identity.
   // const credential = new DefaultAzureCredential();
   
   // For user-assigned managed identity.
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: process.env.AZURE_COSMOS_CLIENTID
   // });
   
   // For service principal.
   // const credential = new ClientSecretCredential(
   //     tenantId: process.env.AZURE_COSMOS_TENANTID,
   //     clientId: process.env.AZURE_COSMOS_CLIENTID,
   //     clientSecret: process.env.AZURE_COSMOS_CLIENTSECRET
   // );
   
   // Create a new instance of CosmosClient using the credential above
   const cosmosClient = new CosmosClient({ 
       process.env.AZURE_COSMOS_RESOURCEENDPOINT, 
       aadCredentials: credential
   });
   

Otros

Para otros lenguajes, puede usar la dirección URL del punto de conexión y otras propiedades que Service Conectar or establece en las variables de entorno para conectarse a Azure Cosmos DB para NoSQL. Para más información sobre las variables de entorno, consulte Integración de Azure Cosmos DB para NoSQL con Service Conectar or.

Identidad administrada asignada por el usuario

Tipo de cliente SpringBoot

El uso de una identidad administrada asignada por el usuario como tipo de autenticación solo está disponible para Spring Cloud Azure versión 4.0 o posterior.

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
spring.cloud.azure.cosmos.credential.managed-identity-enabled	Si se va a habilitar la identidad administrada	true
spring.cloud.azure.cosmos.database	Su base de datos	https://management.azure.com/.default
spring.cloud.azure.cosmos.endpoint	Punto de conexión del recurso	https://<database-server>.documents.azure.com:443/
spring.cloud.azure.cosmos.credential.client-id	Id. de cliente	<client-ID>

Otros tipos de cliente

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_COSMOS_LISTCONNECTIONSTRINGURL	Dirección URL para obtener la cadena de conexión	https://management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/databaseAccounts/<database-server>/listConnectionStrings?api-version=2021-04-15
AZURE_COSMOS_SCOPE	Ámbito de la identidad administrada	https://management.azure.com/.default
AZURE_COSMOS_CLIENTID	Id. de cliente	<client-ID>
AZURE_COSMOS_RESOURCEENDPOINT	Punto de conexión del recurso	https://<database-server>.documents.azure.com:443/

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure Cosmos DB para NoSQL mediante una identidad asignada por el usuario.

.NET

1. Instale las dependencias.

   dotnet add package Microsoft.Azure.Cosmos
   dotnet add package Azure.Identity
   

2. Autentíquese mediante Azure.Identity el paquete NuGet y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   using Microsoft.Azure.Cosmos;
   using Azure.Core;
   using Azure.Identity;
   using System; 
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned identity.
   // TokenCredential credential = new DefaultAzureCredential();
   
   // For user-assigned identity.
   // TokenCredential credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTID");
   //     }
   // );
   
   // For service principal.
   // TokenCredential credential = new ClientSecretCredential(
   //     tenantId: Environment.GetEnvironmentVariable("AZURE_COSMOS_TENANTID")!,
   //     clientId: Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTID")!,
   //     clientSecret: Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTSECRET")!,
   //     options: new TokenCredentialOptions()
   // );
   
   // Create a new instance of CosmosClient using the credential above
   using CosmosClient client = new(
       accountEndpoint: Environment.GetEnvironmentVariable("AZURE_COSMOS_RESOURCEENDPOINT")!,
       tokenCredential: credential
   );
   

Java

1. Agregue las siguientes dependencias al archivo pom.xml:

   <dependency>
   	<groupId>com.azure</groupId>
   	<artifactId>azure-cosmos</artifactId>
   	<version>LATEST</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.1.5</version>
   </dependency>
   

2. Autentíquese a través azure-identity de y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import com.azure.cosmos.CosmosClient;
   import com.azure.cosmos.CosmosClientBuilder;
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_COSMOS_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("<AZURE_COSMOS_CLIENTID>"))
   //   .clientSecret(System.getenv("<AZURE_COSMOS_CLIENTSECRET>"))
   //   .tenantId(System.getenv("<AZURE_COSMOS_TENANTID>"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_COSMOS_RESOURCEENDPOINT");
   
   CosmosClient cosmosClient = new CosmosClientBuilder()
       .endpoint(endpoint)
       .credential(credential)
       .buildClient();
   

SpringBoot

Consulte Compilación de una aplicación de Spring Data Azure Cosmos DB v3 para administrar datos de Azure Cosmos DB para NoSQL para configurar la aplicación Spring. Service Conectar or agrega las propiedades de configuración a Spring Apps. La compatibilidad con identidades administradas para Cosmos DB solo está disponible para Spring Cloud Versión 4.0 y posteriores. Para más información, consulte La documentación de referencia de Spring Cloud Azure.

Python

1. Instale las dependencias.

   pip install azure-identity
   pip install azure-cosmos
   

2. Autentíquese a través azure-identity de la biblioteca y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import os
   from azure.cosmos import CosmosClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines according to the authentication type.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_COSMOS_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_COSMOS_TENANTID')
   # client_id = os.getenv('AZURE_COSMOS_CLIENTID')
   # client_secret = os.getenv('AZURE_COSMOS_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   endpoint = os.environ["AZURE_COSMOS_RESOURCEENDPOINT"]
   client = CosmosClient(url=endpoint, credential=cred)
   
   

Go

1. Instale las dependencias.

   go get t github.com/Azure/azure-sdk-for-go/sdk/azidentity
   go get github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos
   

2. Autentíquese mediante azidentity el paquete npm y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import (
       "os"
   
       "github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos"
       "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   )
   
   func main() {
       endpoint = os.Getenv("AZURE_COSMOS_RESOURCEENDPOINT")
   
       // Uncomment the following lines according to the authentication type.
       // For system-assigned identity.
       // cred, err := azidentity.NewDefaultAzureCredential(nil)
   
       // For user-assigned identity.
       // clientid := os.Getenv("AZURE_COSMOS_CLIENTID")
       // azidentity.ManagedIdentityCredentialOptions.ID := clientid
       // options := &azidentity.ManagedIdentityCredentialOptions{ID: clientid}
       // cred, err := azidentity.NewManagedIdentityCredential(options)
   
       // For service principal.
       // clientid := os.Getenv("AZURE_COSMOS_CLIENTID")
       // tenantid := os.Getenv("AZURE_COSMOS_TENANTID")
       // clientsecret := os.Getenv("AZURE_COSMOS_CLIENTSECRET")
       // cred, err := azidentity.NewClientSecretCredential(tenantid, clientid, clientsecret, &azidentity.ClientSecretCredentialOptions{})
   
       client, err := azcosmos.NewClient(endpoint, cred, nil)
   }
   

NodeJS

1. Instale las dependencias.

   npm install @azure/identity
   npm install @azure/cosmos
   

2. Autentíquese mediante @azure/identity el paquete npm y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import { CosmosClient } from "@azure/cosmos";
   const { DefaultAzureCredential } = require("@azure/identity");
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned managed identity.
   // const credential = new DefaultAzureCredential();
   
   // For user-assigned managed identity.
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: process.env.AZURE_COSMOS_CLIENTID
   // });
   
   // For service principal.
   // const credential = new ClientSecretCredential(
   //     tenantId: process.env.AZURE_COSMOS_TENANTID,
   //     clientId: process.env.AZURE_COSMOS_CLIENTID,
   //     clientSecret: process.env.AZURE_COSMOS_CLIENTSECRET
   // );
   
   // Create a new instance of CosmosClient using the credential above
   const cosmosClient = new CosmosClient({ 
       process.env.AZURE_COSMOS_RESOURCEENDPOINT, 
       aadCredentials: credential
   });
   

Otros

Para otros lenguajes, puede usar la dirección URL del punto de conexión y otras propiedades que Service Conectar or establece en las variables de entorno para conectarse a Azure Cosmos DB para NoSQL. Para más información sobre las variables de entorno, consulte Integración de Azure Cosmos DB para NoSQL con Service Conectar or.

Cadena de conexión

Tipo de cliente SpringBoot

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
azure.cosmos.key	La clave de acceso de la base de datos para Spring Cloud Azure, versión inferior a la 4.0	<access-key>
azure.cosmos.database	Su base de datos para Spring Cloud Azure, versión inferior a la 4.0	<database-name>
azure.cosmos.uri	El URI de la base de datos para Spring Cloud Azure, versión inferior a la 4.0	https://<database-server>.documents.azure.com:443/
spring.cloud.azure.cosmos.key	La clave de acceso de la base de datos para Spring Cloud Azure versión superior a la 4.0	<access-key>
spring.cloud.azure.cosmos.database	La base de datos para Spring Cloud Azure, versión superior a la 4.0	<database-name>
spring.cloud.azure.cosmos.endpoint	El URI de la base de datos para Spring Cloud Azure versión superior a la 4.0	https://<database-server>.documents.azure.com:443/

Otros tipos de cliente

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_COSMOS_CONNECTIONSTRING	Cadena de conexión de Azure Cosmos DB for NoSQL	AccountEndpoint=https://<database-server>.documents.azure.com:443/;AccountKey=<account-key>

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure Cosmos DB para NoSQL mediante un cadena de conexión.

.NET

1. Instale la dependencia.

   dotnet add package Microsoft.Azure.Cosmos
   

2. Obtenga el cadena de conexión de la variable de entorno agregada por Service Conectar or.

   using Microsoft.Azure.Cosmos;
   using System; 
   
   // Create a new instance of CosmosClient using a connection string
   using CosmosClient client = new(
       connectionString: Environment.GetEnvironmentVariable("AZURE_COSMOS_CONNECTIONSTRING")!
   );
   

Java

1. Agregue la dependencia siguiente en el archivo de pom.xml :

   <dependency>
   	<groupId>com.azure</groupId>
   	<artifactId>azure-cosmos</artifactId>
   	<version>LATEST</version>
   </dependency>
   

2. Obtenga el cadena de conexión de la variable de entorno agregada por Service Conectar or.

   import com.azure.cosmos.CosmosClient;
   import com.azure.cosmos.CosmosClientBuilder;
   
   String connectionStr = System.getenv("AZURE_COSMOS_CONNECTIONSTRING");
   String[] connInfo = connectionStr.split(";");
   String endpoint = connInfo[0].split("=")[1];
   String accountKey = connInfo[1].split("=")[1];
   
   CosmosClient cosmosClient = new CosmosClientBuilder()
       .endpoint(endpoint)
       .key(accountKey)
       .buildClient();
   

SpringBoot

Consulte ejemplos de Spring Data Azure Cosmos DB v3 y Creación de una aplicación Spring Data Azure Cosmos DB v3 para administrar datos de Azure Cosmos DB para NoSQL para configurar la aplicación Spring. Service Conectar or agrega las propiedades de configuración a Spring Apps. Se proporcionan dos conjuntos de propiedades de configuración según la versión de Spring Cloud Azure (por debajo de la versión 4.0 y posteriores a la 4.0). Para más información sobre los cambios de biblioteca de Spring Cloud Azure, consulte guía de migración de Azure de Spring Cloud. Se recomienda usar Spring Cloud Azure versión 4.0 y posteriores. Las configuraciones con el formato "azure.cosmos.*" de Spring Cloud Azure 3.x ya no se admitirán después del 1 de julio de 2024.

Python

1. Instale la dependencia.

   pip install azure-cosmos
   

2. Obtenga el cadena de conexión de la variable de entorno agregada por Service Conectar or.

   import os
   from azure.cosmos import CosmosClient
   
   # Create a new instance of CosmosClient using a connection string
   CONN_STR = os.environ["AZURE_COSMOS_CONNECTIONSTRING"]
   client = CosmosClient.from_connection_string(conn_str=CONN_STR) 
   

Go

1. Instale la dependencia.

   go get github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos
   

2. Obtenga el cadena de conexión de la variable de entorno agregada por Service Conectar or.

   import {
       "github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos"
   }
   connectionString := os.Getenv("AZURE_COSMOS_CONNECTIONSTRING")
   client, err := azcosmos.NewClientFromConnectionString(connectionString, nil)
   

NodeJS

1. Instale la dependencia.

   npm install @azure/cosmos
   

2. Obtenga el cadena de conexión de la variable de entorno agregada por Service Conectar or.

   import { CosmosClient } from "@azure/cosmos";
   
   // Create a new instance of CosmosClient using a connection string
   const cosmosClient = new CosmosClient(process.env.AZURE_COSMOS_CONNECTIONSTRING);
   

Otros

Para otros lenguajes, puede usar la dirección URL del punto de conexión y otras propiedades que Service Conectar or establece en las variables de entorno para conectarse a Azure Cosmos DB para NoSQL. Para más información sobre las variables de entorno, consulte Integración de Azure Cosmos DB para NoSQL con Service Conectar or.

Entidad de servicio

Tipo de cliente SpringBoot

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
spring.cloud.azure.cosmos.credential.client-id	Id. de cliente	<client-ID>
spring.cloud.azure.cosmos.credential.client-secret	Secreto de cliente	<client-secret>
spring.cloud.azure.cosmos.profile.tenant-id	El identificador de inquilino	<tenant-ID>
spring.cloud.azure.cosmos.database	Su base de datos	<database-name>
spring.cloud.azure.cosmos.endpoint	Punto de conexión del recurso	https://<database-server>.documents.azure.com:443/

Otros tipos de cliente

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_COSMOS_LISTCONNECTIONSTRINGURL	Dirección URL para obtener la cadena de conexión	https://management.azure.com/subscriptions/<subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/databaseAccounts/<database-server>/listConnectionStrings?api-version=2021-04-15
AZURE_COSMOS_SCOPE	Ámbito de la identidad administrada	https://management.azure.com/.default
AZURE_COSMOS_CLIENTID	Identificador del secreto de cliente	<client-ID>
AZURE_COSMOS_CLIENTSECRET	Secreto de cliente	<client-secret>
AZURE_COSMOS_TENANTID	El identificador de inquilino	<tenant-ID>
AZURE_COSMOS_RESOURCEENDPOINT	Punto de conexión del recurso	https://<database-server>.documents.azure.com:443/

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure Cosmos DB para NoSQL mediante una entidad de servicio.

.NET

1. Instale las dependencias.

   dotnet add package Microsoft.Azure.Cosmos
   dotnet add package Azure.Identity
   

2. Autentíquese mediante Azure.Identity el paquete NuGet y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   using Microsoft.Azure.Cosmos;
   using Azure.Core;
   using Azure.Identity;
   using System; 
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned identity.
   // TokenCredential credential = new DefaultAzureCredential();
   
   // For user-assigned identity.
   // TokenCredential credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTID");
   //     }
   // );
   
   // For service principal.
   // TokenCredential credential = new ClientSecretCredential(
   //     tenantId: Environment.GetEnvironmentVariable("AZURE_COSMOS_TENANTID")!,
   //     clientId: Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTID")!,
   //     clientSecret: Environment.GetEnvironmentVariable("AZURE_COSMOS_CLIENTSECRET")!,
   //     options: new TokenCredentialOptions()
   // );
   
   // Create a new instance of CosmosClient using the credential above
   using CosmosClient client = new(
       accountEndpoint: Environment.GetEnvironmentVariable("AZURE_COSMOS_RESOURCEENDPOINT")!,
       tokenCredential: credential
   );
   

Java

1. Agregue las siguientes dependencias al archivo pom.xml:

   <dependency>
   	<groupId>com.azure</groupId>
   	<artifactId>azure-cosmos</artifactId>
   	<version>LATEST</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.1.5</version>
   </dependency>
   

2. Autentíquese a través azure-identity de y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import com.azure.cosmos.CosmosClient;
   import com.azure.cosmos.CosmosClientBuilder;
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_COSMOS_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("<AZURE_COSMOS_CLIENTID>"))
   //   .clientSecret(System.getenv("<AZURE_COSMOS_CLIENTSECRET>"))
   //   .tenantId(System.getenv("<AZURE_COSMOS_TENANTID>"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_COSMOS_RESOURCEENDPOINT");
   
   CosmosClient cosmosClient = new CosmosClientBuilder()
       .endpoint(endpoint)
       .credential(credential)
       .buildClient();
   

SpringBoot

Consulte Compilación de una aplicación de Spring Data Azure Cosmos DB v3 para administrar datos de Azure Cosmos DB para NoSQL para configurar la aplicación Spring. Service Conectar or agrega las propiedades de configuración a Spring Apps. La compatibilidad con identidades administradas para Cosmos DB solo está disponible para Spring Cloud Versión 4.0 y posteriores. Para más información, consulte La documentación de referencia de Spring Cloud Azure.

Python

1. Instale las dependencias.

   pip install azure-identity
   pip install azure-cosmos
   

2. Autentíquese a través azure-identity de la biblioteca y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import os
   from azure.cosmos import CosmosClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines according to the authentication type.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_COSMOS_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_COSMOS_TENANTID')
   # client_id = os.getenv('AZURE_COSMOS_CLIENTID')
   # client_secret = os.getenv('AZURE_COSMOS_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   
   endpoint = os.environ["AZURE_COSMOS_RESOURCEENDPOINT"]
   client = CosmosClient(url=endpoint, credential=cred)
   
   

Go

1. Instale las dependencias.

   go get t github.com/Azure/azure-sdk-for-go/sdk/azidentity
   go get github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos
   

2. Autentíquese mediante azidentity el paquete npm y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import (
       "os"
   
       "github.com/Azure/azure-sdk-for-go/sdk/data/azcosmos"
       "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
   )
   
   func main() {
       endpoint = os.Getenv("AZURE_COSMOS_RESOURCEENDPOINT")
   
       // Uncomment the following lines according to the authentication type.
       // For system-assigned identity.
       // cred, err := azidentity.NewDefaultAzureCredential(nil)
   
       // For user-assigned identity.
       // clientid := os.Getenv("AZURE_COSMOS_CLIENTID")
       // azidentity.ManagedIdentityCredentialOptions.ID := clientid
       // options := &azidentity.ManagedIdentityCredentialOptions{ID: clientid}
       // cred, err := azidentity.NewManagedIdentityCredential(options)
   
       // For service principal.
       // clientid := os.Getenv("AZURE_COSMOS_CLIENTID")
       // tenantid := os.Getenv("AZURE_COSMOS_TENANTID")
       // clientsecret := os.Getenv("AZURE_COSMOS_CLIENTSECRET")
       // cred, err := azidentity.NewClientSecretCredential(tenantid, clientid, clientsecret, &azidentity.ClientSecretCredentialOptions{})
   
       client, err := azcosmos.NewClient(endpoint, cred, nil)
   }
   

NodeJS

1. Instale las dependencias.

   npm install @azure/identity
   npm install @azure/cosmos
   

2. Autentíquese mediante @azure/identity el paquete npm y obtenga la dirección URL del punto de conexión de la variable de entorno agregada por Service Conectar or. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea usar.

   import { CosmosClient } from "@azure/cosmos";
   const { DefaultAzureCredential } = require("@azure/identity");
   
   // Uncomment the following lines according to the authentication type.
   // For system-assigned managed identity.
   // const credential = new DefaultAzureCredential();
   
   // For user-assigned managed identity.
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: process.env.AZURE_COSMOS_CLIENTID
   // });
   
   // For service principal.
   // const credential = new ClientSecretCredential(
   //     tenantId: process.env.AZURE_COSMOS_TENANTID,
   //     clientId: process.env.AZURE_COSMOS_CLIENTID,
   //     clientSecret: process.env.AZURE_COSMOS_CLIENTSECRET
   // );
   
   // Create a new instance of CosmosClient using the credential above
   const cosmosClient = new CosmosClient({ 
       process.env.AZURE_COSMOS_RESOURCEENDPOINT, 
       aadCredentials: credential
   });
   

Otros

Para otros lenguajes, puede usar la dirección URL del punto de conexión y otras propiedades que Service Conectar or establece en las variables de entorno para conectarse a Azure Cosmos DB para NoSQL. Para más información sobre las variables de entorno, consulte Integración de Azure Cosmos DB para NoSQL con Service Conectar or.

Pasos siguientes

Para más información sobre Service Connector, siga los tutoriales que se enumeran a continuación.

Más información sobre los conceptos de Service Connector