共用方式為


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 進行容量規劃嗎? 您可以使用現有資料庫叢集的相關資訊進行容量規劃。