將 Azure Cosmos DB 資料庫連線至 Azure Spring 應用程式應用程式

發行項
11/20/2024

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於：✅ Java ✅ C#

本文適用於：✅ 基本/標準 ✅ 企業

您可以使用 Azure Spring Apps 自動將選取的 Azure 服務連線到您的應用程式，而不是手動設定 Spring Boot 應用程式。本文示範如何將應用程式連線到 Azure Cosmos DB 資料庫。

必要條件

部署至 Azure Spring Apps 的應用程式。如需詳細資訊，請參閱快速入門：將第一個應用程式部署至 Azure Spring Apps。
Azure Cosmos DB 資料庫實例。
Azure CLI 2.45.0 版或更新版本。

將下列其中一個相依性新增至應用程式的 pom.xml 檔案。選擇適合您 API 類型的相依性。

API 類型：NoSQL

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
</dependency>

API 類型：MongoDB

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>

API 類型：Cassandra

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-cassandra</artifactId>
</dependency>

執行 az spring app deploy來更新目前的應用程式，或執行 az spring app deployment create來建立此變更的新部署。

將您的應用程式連線至 Azure Cosmos DB

服務連接器
Terraform

注意

根據預設，服務連接器會在應用層級建立。若要覆寫連線，您可以在部署中再次建立其他連線。

使用 Azure CLI

使用 Azure CLI 來設定 Spring 應用程式以使用 az spring connection create 命令連線到 Cosmos No SQL 資料庫，如下列範例所示。請務必將範例中的變數取代為實際值。

注意

更新 Azure Cosmos DB 資料庫設定可能需要幾分鐘的時間才能完成。

注意

如果您使用 Cosmos Cassandra 請使用 --key_space 而非 --database。如果您使用 Cosmos Table，請使用 --table 而非 --database。如需詳細資訊，請參閱快速入門：使用 Azure CLI 在 Azure Spring Apps 中建立服務連線。

az spring connection create cosmos-sql \
    --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
    --app $APP_NAME \
    --target-resource-group $COSMOSDB_RESOURCE_GROUP \
    --account $COSMOSDB_ACCOUNT_NAME \
    --database $DATABASE_NAME \
    --secret

注意

如果您是第一次使用 Service Connector，請從執行命令az provider register --namespace Microsoft.ServiceLinker來註冊 Service Connector 資源提供者開始。

提示

執行命令 az spring connection list-support-types --output table 以取得 Azure Spring Apps 支援的目標服務和驗證方法清單。如果系統無法辨識 az spring 命令，請執行 az extension add --name spring 來檢查您是否已安裝必要的延伸模組。

使用 Azure 入口網站

或者，您可以完成下列步驟，使用 Azure 入口網站來設定此連線。 Azure 入口網站提供與 Azure CLI 相同的功能，並提供互動式體驗。

在 Azure 入口網站中選取您的 Azure Spring Apps 實例，然後從導覽功能表中選取 [應用程式]。選擇您要連線的應用程式，然後選取 導覽功能表上的 [服務連接器 ]。
選取建立。
在 [ 基本] 索引 標籤上，針對服務類型，選取 [Cosmos DB]，然後選擇訂用帳戶。針對 [API 類型]，選取 [核心][SQL]、選擇 [Cosmos DB 帳戶] 和 [資料庫]。針對客戶端類型，選取 [Java]，然後選取 [ 下一步：驗證]。如果您尚未建立資料庫，請參閱快速入門：從 Azure 入口網站建立 Azure Cosmos DB 帳戶、資料庫、容器和專案。
在 [驗證] 索引標籤上，選擇 [連接字串]。 服務連接器會自動從 Cosmos DB 帳戶擷取存取金鑰。選取 [下一步：網路]。
在 [網络] 索引標籤上，選取 [設定防火牆規則] 以啟用目標服務的存取權，然後選取 [下一步：檢閱 + 建立]。
在 [ 檢閱 + 建立] 索引標籤上，等候驗證通過，然後選取 [ 建立]。建立可能需要幾分鐘的時間才能完成。
一旦產生 Spring 應用程式與 Cosmos DB 資料庫之間的連線之後，您可以在 [服務連接器] 頁面中看到它，然後選取展開按鈕來檢視已設定的連接變數。

下列 Terraform 腳本示範如何使用 Azure Cosmos DB 帳戶設定部署至 Azure Spring Apps 的應用程式。

provider "azurerm" {
  features {}
}

variable "application_name" {
  type        = string
  description = "The name of your application"
  default     = "demo-cosmosdb"
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_cosmosdb_account" "cosmosdb" {
  name                = "cosmosacct-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  offer_type          = "Standard"
  kind                = "GlobalDocumentDB"

  consistency_policy {
    consistency_level = "Session"
  }

  geo_location {
    failover_priority = 0
    location          = azurerm_resource_group.example.location
  }
}

resource "azurerm_cosmosdb_sql_database" "cosmosdb" {
  name                = "cosmos-${var.application_name}-001"
  resource_group_name = azurerm_cosmosdb_account.cosmosdb.resource_group_name
  account_name        = azurerm_cosmosdb_account.cosmosdb.name
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "${var.application_name}"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
}

resource "azurerm_spring_cloud_app" "example" {
  name                = "${var.application_name}-app"
  resource_group_name = azurerm_resource_group.example.name
  service_name        = azurerm_spring_cloud_service.example.name
  is_public           = true
  https_only          = true
}

resource "azurerm_spring_cloud_java_deployment" "example" {
  name                = "default"
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  quota {
    cpu    = "2"
    memory = "4Gi"
  }
  instance_count      = 1
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.cloud.azure.cosmos.endpoint" : azurerm_cosmosdb_account.cosmosdb.endpoint
    "spring.cloud.azure.cosmos.key" : azurerm_cosmosdb_account.cosmosdb.primary_key
    "spring.cloud.azure.cosmos.database" : azurerm_cosmosdb_sql_database.cosmosdb.name
  }
}

resource "azurerm_spring_cloud_active_deployment" "example" {
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  deployment_name     = azurerm_spring_cloud_java_deployment.example.name
}

下一步

在本文中，您已瞭解如何將 Azure Spring Apps 中的應用程式連線到 Azure Cosmos DB 資料庫。若要深入瞭解如何將服務連線到您的應用程式，請參閱連線到 Azure Cache for Redis 快取。

共用方式為