Compartilhar via


Integrar o Banco de Dados SQL do Azure com o Conector de Serviço

Este artigo aborda métodos de autenticação com suporte, clientes e código de exemplo que você pode usar para conectar seus aplicativos ao Banco de Dados SQL do Azure usando o Conector de Serviço. Neste artigo, você também encontrará nomes, valores e configuração de variáveis de ambiente padrão obtidos ao criar conexões de serviço.

Serviço de computação com suporte

O Conector de Serviço pode ser usado para conectar os seguintes serviços de computação ao Banco de Dados SQL do Azure:

  • Serviço de Aplicativo do Azure
  • Aplicativos de Contêiner do Azure
  • Azure Functions
  • Serviço de Kubernetes do Azure (AKS)
  • Aplicativos Spring do Azure

Tipos de autenticação e de clientes com suporte

A tabela abaixo mostra quais combinações de clientes e métodos de autenticação têm suporte para conectar o serviço de computação ao Banco de Dados SQL do Azure usando o conector de serviço. “Sim” indica que a combinação tem suporte e “Não” indica que ela não tem.

Tipo de cliente Identidade gerenciada atribuída pelo sistema Identidade gerenciada atribuída pelo usuário Cadeia de conexão/segredo Entidade de serviço
.NET Sim Sim Sim Sim
Go Não Não Sim Não
Java Sim Sim Sim Sim
Java – Spring Boot Sim Sim Sim Sim
Node.js Sim Sim Sim Sim
PHP Não Não Sim Não
Python Sim Sim Sim Sim
Python – Django Não Não Sim Não
Ruby Não Não Sim Não
Nenhum Sim Sim Sim Sim

Observação

A identidade gerenciada atribuída pelo sistema, a identidade gerenciada atribuída pelo usuário e a autenticação da entidade de serviço só têm suporte na CLI do Azure.

Nomes de variáveis de ambiente padrão ou propriedades de aplicativo e código de exemplo

Use os detalhes de conexão abaixo para conectar serviços de computação ao Banco de Dados SQL do Azure. Para cada exemplo abaixo, substitua os textos de espaços reservados <sql-server>, <sql-database>, <sql-username> e <sql-password> pelo seguinte: nome do servidor, nome do banco de dados, ID de usuário e senha. Para saber mais sobre as convenções de nomenclatura, confira o artigo Detalhes internos do Conector de Serviço.

Identidade gerenciada atribuída pelo sistema

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_SQL_CONNECTIONSTRING Cadeia de conexão do Banco de Dados SQL do Azure Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Authentication=ActiveDirectoryManagedIdentity

Código de exemplo

Confira as etapas e o código abaixo para se conectar ao Banco de Dados SQL do Azure usando uma identidade gerenciada atribuída pelo sistema.

  1. Instale as dependências.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenha a cadeia de conexão do Banco de Dados SQL do Azure da variável de ambiente adicionada pelo Conector do Serviço.

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

    Para obter mais informações, consulte Usando a autenticação de Identidade Gerenciada do Active Directory.

Para obter mais informações, confira Página inicial para a programação de cliente para interagir com o Microsoft SQL Server.

Identidade gerenciada atribuída pelo usuário

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_SQL_CONNECTIONSTRING Cadeia de conexão do Banco de Dados SQL do Azure Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<identity-client-ID>;Authentication=ActiveDirectoryManagedIdentity

Código de exemplo

Confira as etapas e o código abaixo para se conectar ao Banco de Dados SQL do Azure usando uma identidade gerenciada atribuída pelo usuário.

  1. Instale as dependências.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenha a cadeia de conexão do Banco de Dados SQL do Azure da variável de ambiente adicionada pelo Conector do Serviço.

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

    Para obter mais informações, consulte Usando a autenticação de Identidade Gerenciada do Active Directory.

Para obter mais informações, confira Página inicial para a programação de cliente para interagir com o Microsoft SQL Server.

Cadeia de conexão

Aviso

A Microsoft recomenda usar o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento exige um grau muito alto de confiança no aplicativo e traz riscos que não estão presentes em outros fluxos. Você só deve usar esse fluxo quando outros fluxos mais seguros, como identidades gerenciadas, não forem viáveis.

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_SQL_CONNECTIONSTRING Cadeia de conexão do Banco de Dados SQL do Azure Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Password=<sql-password>

Código de exemplo

Confira as etapas e o código abaixo para se conectar ao Banco de Dados SQL do Azure usando uma cadeia de conexão.

  1. Instale as dependências.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenha a cadeia de conexão do Banco de Dados SQL do Azure da variável de ambiente adicionada pelo Conector do Serviço.

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

Para obter mais informações, confira Página inicial para a programação de cliente para interagir com o Microsoft SQL Server.

Entidade de serviço

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_SQL_CLIENTID Sua ID de cliente <client-ID>
AZURE_SQL_CLIENTSECRET O segredo do cliente <client-secret>
AZURE_SQL_TENANTID Sua ID de locatário <tenant-ID>
AZURE_SQL_CONNECTIONSTRING Cadeia de conexão do Banco de Dados SQL do Azure Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<client-Id>;Password=<client-secret>;Authentication=ActiveDirectoryServicePrincipal

Código de exemplo

Confira as etapas e o código abaixo para se conectar ao Banco de Dados SQL do Azure usando uma entidade de serviço.

  1. Instale as dependências.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Obtenha a cadeia de conexão do Banco de Dados SQL do Azure da variável de ambiente adicionada pelo Conector do Serviço.

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

    Para obter mais informações, consulte Usando a autenticação de Identidade Gerenciada do Active Directory.

Para obter mais informações, confira Página inicial para a programação de cliente para interagir com o Microsoft SQL Server.

Próximas etapas

Siga os tutoriais listados abaixo para saber mais sobre o Conector de Serviço.