共用方式為


使用服務連接器整合 Azure SQL Database

此頁面會顯示支援的驗證方法和用戶端,並顯示範例程式碼,您可以用來將計算服務連線到使用服務連接器的 Azure SQL Database。 您可能仍可以使用其他方法連線到 Azure SQL Database。 此頁面也顯示您在建立服務連線時取得的預設環境變數名稱和值。

支援的計算服務

服務連接器可用來將下列計算服務連線至 Azure SQL Database:

  • Azure App Service
  • Azure 容器應用程式
  • Azure Functions
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

支援的驗證類型和用戶端

下表顯示使用服務連接器將計算服務連線到 Azure SQL Database 時,支援哪些驗證方法和用戶端組合。 「是」表示支援的組合,而「否」則表示不支援。

用戶端類型 系統指派的受控識別 使用者指派的受控識別 祕密/連接字串 服務主體
.NET Yes .是 .是 Yes
Go No .是 No
Java Yes .是 .是 Yes
Java - Spring Boot Yes .是 .是 Yes
Node.js Yes .是 .是 Yes
PHP No .是 No
Python Yes .是 .是 Yes
Python - Django No .是 No
Ruby No .是 No
Yes .是 .是 Yes

下表指出所有用戶端類型都支援祕密/連接字串方法。 .NET、JAVA、JAVA - Spring Boot、Node.js、Python 和 None 用戶端類型支援系統指派的受控識別、使用者指派的受控識別和服務主體方法。 Go、PHP、Django 和 Ruby 用戶端類型不支援這些方法。

注意

系統指派的受控識別、使用者指派的受控識別和服務主體僅在 Azure CLI 中受到支援。

預設環境變數名稱或應用程式屬性和範例程式碼

使用下列連線詳細資料,將計算服務連線到 Azure SQL Database。 在下列每個範例中,以您的伺服器名稱、資料庫名稱、使用者名稱和密碼取代預留位置文字<sql-server><sql-database><sql-username><sql-password>。 如需命名慣例的詳細資訊,請參閱服務連接器內部一文。

系統指派的受控識別

預設環境變數名稱 描述 範例值
AZURE_SQL_CONNECTIONSTRING Azure SQL Database 連接字串 Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Authentication=ActiveDirectoryManagedIdentity

範例指令碼

請參閱下面的步驟和程式碼,以使用系統指派的受控識別來連線到 Azure SQL Database。

  1. 安裝相依性。

    dotnet add package Microsoft.Data.SqlClient
    
  2. 從服務連接器新增的環境變數取得 Azure SQL Database 連結字串。

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

    如需詳細資訊,請參閱使用 Active Directory 受控識別驗證

如需更多資訊,請參閱 Microsoft SQL Server 用戶端程式設計的首頁

使用者指派的受控識別

預設環境變數名稱 描述 範例值
AZURE_SQL_CONNECTIONSTRING Azure SQL Database 連接字串 Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<identity-client-ID>;Authentication=ActiveDirectoryManagedIdentity

範例指令碼

請參閱下面的步驟和程式碼,以使用使用者指派的受控識別來連線到 Azure SQL Database。

  1. 安裝相依性。

    dotnet add package Microsoft.Data.SqlClient
    
  2. 從服務連接器新增的環境變數取得 Azure SQL Database 連結字串。

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

    如需詳細資訊,請參閱使用 Active Directory 受控識別驗證

如需更多資訊,請參閱 Microsoft SQL Server 用戶端程式設計的首頁

連接字串

警告

Microsoft 建議您使用最安全的可用驗證流程。 這個程序描述的驗證流程需要在應用程式中具備極高的信任度,且伴隨著其他流程並未面臨的風險。 請僅在其他較安全的流程 (例如受控身分識別) 皆不具可行性的情況下,才使用這個流程。

預設環境變數名稱 描述 範例值
AZURE_SQL_CONNECTIONSTRING Azure SQL Database 連接字串 Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Password=<sql-password>

範例指令碼

請參閱下面的步驟和程式碼,以使用連接字串來連線到 Azure SQL Database。

  1. 安裝相依性。

    dotnet add package Microsoft.Data.SqlClient
    
  2. 從服務連接器新增的環境變數取得 Azure SQL Database 連結字串。

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

如需更多資訊,請參閱 Microsoft SQL Server 用戶端程式設計的首頁

服務主體

預設環境變數名稱 描述 範例值
AZURE_SQL_CLIENTID 您的用戶端識別碼 <client-ID>
AZURE_SQL_CLIENTSECRET 您的用戶端密碼 <client-secret>
AZURE_SQL_TENANTID 您的租用戶識別碼 <tenant-ID>
AZURE_SQL_CONNECTIONSTRING Azure SQL Database 連接字串 Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<client-Id>;Password=<client-secret>;Authentication=ActiveDirectoryServicePrincipal

範例指令碼

請參閱下面的步驟和程式碼,以使用服務主體來連線到 Azure SQL Database。

  1. 安裝相依性。

    dotnet add package Microsoft.Data.SqlClient
    
  2. 從服務連接器新增的環境變數取得 Azure SQL Database 連結字串。

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

    如需詳細資訊,請參閱使用 Active Directory 受控識別驗證

如需更多資訊,請參閱 Microsoft SQL Server 用戶端程式設計的首頁

下一步

請透過下方列出的教學課程深入了解服務連接器。