Compartir a través de


Integración de Azure SQL Database con un conector de servicio

En esta página se muestran los métodos de autenticación y los clientes admitidos y se muestra el código de ejemplo que puede usar para conectar los servicios de proceso a Azure SQL Database mediante el conector de servicio. Es posible que todavía pueda conectarse a Azure SQL Database mediante otros métodos. Esta página también muestra los nombres y valores predeterminados de las variables de entorno que se obtiene al crear la conexión de servicio.

Servicios de proceso admitidos

El conector de servicio se puede utilizar para conectar los siguientes servicios de proceso a Azure SQL Database:

  • Azure App Service
  • Azure Container Apps
  • Funciones de Azure
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

Tipos de autenticación y clientes admitidos

En la tabla siguiente se muestran las combinaciones de métodos de autenticación y clientes que se admiten para conectar el servicio de proceso a Azure SQL Database mediante el conector de servicio. 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
Go No No No
Java
Java: Spring Boot
Node.js
PHP No No No
Python
Python: Django No No No
Ruby No No No
Ninguno

En esta tabla se indica que se admite el método de cadena de conexión o secreto para todos los tipos de cliente. Los métodos de identidad administrada asignada por el sistema, de identidad administrada asignada por el usuario y de entidad de servicio son compatibles con los tipos de cliente .NET, Java, Java - Spring Boot, Node.js, Python y None. Estos métodos no se admiten para los tipos de cliente Go, PHP, Django y Ruby.

Nota:

La identidad administrada asignada por el sistema, la identidad administrada asignada por el usuario y la entidad de servicio solo se admiten en la CLI de Azure.

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 servicios de proceso a Azure SQL Database. Para cada ejemplo siguiente, reemplace los textos de los marcadores de posición <sql-server>, <sql-database>, <sql-username> y <sql-password> por su propio nombre de servidor, el nombre de la base de datos, el identificador de usuario y la contraseña. Para más información sobre las convenciones de nomenclatura, consulte el artículo sobre los elementos internos del conector de servicio.

Identidad administrada asignada por el sistema

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_SQL_CONNECTIONSTRING Cadena de conexión de Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Authentication=ActiveDirectoryManagedIdentity

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure SQL Database mediante una identidad administrada asignada por el sistema.

  1. Instale las dependencias.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenga la cadena de conexión de Azure SQL Database de la variable de entorno agregada por Service Connector.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Para obtener más información, consulte Uso de la autenticación de identidad administrada de Active Directory.

Para obtener más información, consulte Página principal de la programación de cliente en Microsoft SQL Server.

Identidad administrada asignada por el usuario

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_SQL_CONNECTIONSTRING Cadena de conexión de Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<identity-client-ID>;Authentication=ActiveDirectoryManagedIdentity

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure SQL Database mediante una identidad administrada asignada por el usuario.

  1. Instale las dependencias.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenga la cadena de conexión de Azure SQL Database de la variable de entorno agregada por Service Connector.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Para obtener más información, consulte Uso de la autenticación de identidad administrada de Active Directory.

Para obtener más información, consulte Página principal de la programación de cliente en Microsoft SQL Server.

Cadena de conexión

Advertencia

Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación que se describe en este procedimiento requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_SQL_CONNECTIONSTRING Cadena de conexión de Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Password=<sql-password>

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure SQL Database mediante una cadena de conexión.

  1. Instale las dependencias.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenga la cadena de conexión de Azure SQL Database de la variable de entorno agregada por Service Connector.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

Para obtener más información, consulte Página principal de la programación de cliente en Microsoft SQL Server.

Entidad de servicio

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_SQL_CLIENTID Id. de cliente <client-ID>
AZURE_SQL_CLIENTSECRET Secreto de cliente <client-secret>
AZURE_SQL_TENANTID El identificador de inquilino <tenant-ID>
AZURE_SQL_CONNECTIONSTRING Cadena de conexión de Azure SQL Database Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<client-Id>;Password=<client-secret>;Authentication=ActiveDirectoryServicePrincipal

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure SQL Database mediante una entidad de servicio.

  1. Instale las dependencias.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenga la cadena de conexión de Azure SQL Database de la variable de entorno agregada por Service Connector.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Para obtener más información, consulte Uso de la autenticación de identidad administrada de Active Directory.

Para obtener más información, consulte Página principal de la programación de cliente en Microsoft SQL Server.

Pasos siguientes

Para más información sobre el conector de servicio, siga el tutorial que se muestra a continuación.