共用方式為

Azure Cosmos DB for NoSQL：Spring Data Azure Cosmos DB v5 範例

  • 發行項

適用於：NoSQL

重要

這些發行備註適用於第 5 版的 Spring Data Azure Cosmos DB。 您可以在這裡找到第 3 版和第 2 版的發行備註。

Spring Data Azure Cosmos DB 僅支援 API for NoSQL。

請參閱下列文章，以取得與其他 Azure Cosmos DB API 上的 Spring Data 有關的資訊：

重要

如果您沒有 Azure 訂用帳戶，請在開始之前先建立 Azure 免費帳戶。

您可以免費試用 Azure Cosmos DB，不需 Azure 訂用帳戶，也不需要承諾用量。 或者，您可以建立 Azure Cosmos DB 免費層帳戶，免費使用前 1000 RU/秒和 25 GB 的儲存體。 您也可以搭配 https://localhost:8081 的 URI 使用 Azure Cosmos DB 模擬器。 如需要搭配模擬器使用的金鑰，請參閱驗證要求。

azure-spring-boot-samples GitHub 存放庫中包括可對 Azure Cosmos DB 資源執行 CRUD 作業和其他常見作業的最新範例應用程式。 本文提供：

  • 每個範例 Spring Data Azure Cosmos DB 專案檔中各項工作的連結。
  • 相關 API 參考內容的連結。

先決條件

執行此範例應用程式需要下列項目：

  • Java Development Kit 8
  • Spring Data Azure Cosmos DB v5

您可選擇使用 Maven 來取得最新的 Spring Data Azure Cosmos DB v3 二進位檔，以用於您的專案中。 Maven 會自動加入任何必要的相依性。 否則，您可以直接下載 pom.xml 檔案中列出的相依性，並將其新增至您的組建路徑。

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

執行範例應用程式

複製範例存放庫：

$ git clone https://github.com/Azure-Samples/azure-spring-boot-samples

$ cd cosmos/azure-spring-data-cosmos/spring3-samples/cosmos-quickstart-samples

您可以使用 IDE (Eclipse、IntelliJ 或 VS Code) 或從命令列使用 Maven 來執行範例。

必須在 application.properties 中設定這些環境變數，

cosmos.uri=${ACCOUNT_HOST}
cosmos.key=${ACCOUNT_KEY}
cosmos.secondaryKey=${SECONDARY_ACCOUNT_KEY}

dynamic.collection.name=spel-property-collection
# Populate query metrics
cosmos.queryMetricsEnabled=true

以將您的帳戶、資料庫和容器的讀取/寫入存取權授與範例。

您的 IDE 可能會提供執行 Spring Data 範例程式碼的功能。 若未提供，您可以使用下列終端機命令來執行範例：

mvn spring-boot:run

文件 CRUD 範例

範例檔案會說明如何執行下列工作。 若要在執行下列範例之前先了解 Azure Cosmos DB 文件，請參閱使用資料庫、容器和項目概念性文章。

Task API 參考
建立文件 CosmosRepository.save
依識別碼讀取文件 CosmosRepository.derivedQueryMethod
刪除所有文件 CosmosRepository.deleteAll

衍生的查詢方法範例

範例檔案會說明如何執行下列工作。 若要在執行下列範例之前了解 Azure Cosmos DB 查詢，閱讀 Baeldung 的 Spring 中的衍生查詢方法一文，可能有所幫助。

| 查詢文件 | CosmosRepository.derivedQueryMethod |

自訂查詢範例

範例檔案會說明如何使用 SQL 查詢文法執行下列工作。 若要在執行下列範例之前先了解 Azure Cosmos DB 中的 SQL 查詢參考，請參閱適用於 Azure Cosmos DB 的 SQL 查詢範例。

Task API 參考
查詢所有文件 @Query 註釋
使用 == 查詢等號比較 @Query 註釋
使用 != 和 NOT 查詢不等比較 @Query 註釋
使用 >、<、>=、<= 等範圍運算子進行查詢 @Query 註釋
使用範圍運算子對字串進行查詢 @Query 註釋
使用 ORDER BY 進行查詢 @Query 註釋
使用 DISTINCT 進行查詢 @Query 註釋
使用彙總函式進行查詢 @Query 註釋
使用子文件 @Query 註釋
使用文件內聯結進行查詢 @Query 註釋
使用字串、數學和陣列運算子進行查詢 @Query 註釋

下一步

正在嘗試為遷移至 Azure Cosmos DB 進行容量規劃嗎？ 您可以使用現有資料庫叢集的相關資訊進行容量規劃。