使用 Spring Data 搭配支援 MongoDB 的 Azure Cosmos DB API

發行項
01/20/2025

本文示範如何使用 Spring Data 建立範例應用程式，以使用適用於 MongoDB 的 Azure Cosmos DB 來儲存和擷取資訊。

先決條件

Azure 訂用帳戶 - 可免費建立一個。
Java Development Kit （JDK）版本 8 或更高。
Apache Maven。
Azure CLI。

Git 用戶端。

建立 Azure Cosmos DB 帳戶

使用 Azure 入口網站建立 Azure Cosmos DB 帳戶

注意

您可以在 Azure Cosmos DB 檔中閱讀建立帳戶的詳細資訊。

在 https://portal.azure.com/ 流覽至 Azure 入口網站並登入。
選取 [建立資源]，然後再選取 [資料庫]，接著選取 [Azure Cosmos DB]。
在 [選取 API 選項] 畫面上，選取 [Azure Cosmos DB for MongoDB]。
指定以下資訊：
- 訂用帳戶：指定要使用的 Azure 訂用帳戶。
- 資源群組：指定是要建立新的資源群組，還是選擇現有的資源群組。
- 帳戶名稱：為您的 Azure Cosmos DB 帳戶選擇唯一名稱，這將用來建立完整域名，例如 wingtiptoysmongodb.documents.azure.com。
- API：為此教學指定 Azure Cosmos DB for MongoDB API。
- 位置：指定資料庫最接近的地理區域。
輸入上述所有資訊之後，請按一下 檢閱 + 建立。
如果檢閱頁面上的所有項目看起來都正確，請點擊建立。

擷取 Azure Cosmos DB 帳戶的連接字串

在 https://portal.azure.com/ 流覽至 Azure 入口網站並登入。
按兩下 [[所有資源]，然後按下您剛才建立的 Azure Cosmos DB 帳戶。
按兩下 [連接字串]，然後複製 [主要連接字串] 字段的值;您稍後會使用該值來設定應用程式。

設定範例應用程式

開啟命令殼層，並使用 git 命令複製範例專案，如下列範例所示：
```
git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
```
在範例專案的 <專案根目錄>/complete/src/main 目錄中建立資源目錄，並在 resources 目錄中建立 application.properties 檔案。
在文本編輯器中開啟 application.properties 檔案，並在檔案中新增下列幾行，並以先前的適當值取代範例值：
```
spring.data.mongodb.database=wingtiptoysmongodb
spring.data.mongodb.uri=mongodb://wingtiptoysmongodb:AbCdEfGhIjKlMnOpQrStUvWxYz==@wingtiptoysmongodb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb
```
哪裡：

參數描述

spring.data.mongodb.database 指定本文前面提到的 Azure Cosmos DB 帳戶名稱。

spring.data.mongodb.uri 指定來自本文稍早所述的 主要連接字串。
儲存並關閉 application.properties 檔案。

參數	描述
`spring.data.mongodb.database`	指定本文前面提到的 Azure Cosmos DB 帳戶名稱。
`spring.data.mongodb.uri`	指定來自本文稍早所述的主要連接字串。

封裝及測試範例應用程式

若要建置應用程式，請流覽至包含 pom.xml 檔案的目錄 /gs-accessing-data-mongodb/complete。

使用 Maven 建置範例應用程式，並設定 Maven 略過測試;例如：
```
mvn clean package -DskipTests
```

啟動範例應用程式;例如：


java -jar target/accessing-data-mongodb-complete-0.0.1-SNAPSHOT.jar

您的應用程式應該會傳回如下的值：

Customers found with findAll():
-------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']

Customer found with findByFirstName('Alice'):
--------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customers found with findByLastName('Smith'):
--------------------------------
Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']

總結

在本教學課程中，您已建立使用 Spring Data 來儲存及擷取使用適用於 MongoDB 的 Azure Cosmos DB 資訊的範例 Java 應用程式。

清除資源

不再需要時，請使用 Azure 入口網站刪除本文中建立的資源，以避免產生非預期的費用。

後續步驟

若要深入瞭解 Spring 和 Azure，請繼續前往 Azure 上的 Spring 檔中心。

在天藍中的春天

另請參閱

如需搭配 Java 使用 Azure 的詳細資訊，請參閱適用於 Java 開發人員的 Azure，以及使用 Azure DevOps 和 Java。

共用方式為