Wprowadzenie do Azure Cosmos DB dla bazy danych MongoDB przy użyciu języka JavaScript

Dotyczy: ✅ MongoDB

DOTYCZY: Mongodb

Ważna

Czy chcesz przeprowadzić migrację istniejącej aplikacji bazy danych MongoDB lub używać funkcji języka zapytań MongoDB (MQL)? Rozważ użycie usługi Azure DocumentDB.

Szukasz rozwiązania bazy danych dla scenariuszy o dużej skali z umową SLA gwarantującą poziom dostępności na poziomie 99,999%, natychmiastowym skalowaniem automatycznym i automatycznym przełączaniem awaryjnym między wieloma regionami? Rozważmy usługę Azure Cosmos DB dla noSQL.

W tym artykule pokazano, jak nawiązać połączenie z Azure Cosmos DB dla bazy danych MongoDB przy użyciu natywnego pakietu npm bazy danych MongoDB. Po nawiązaniu połączenia można wykonywać operacje na bazach danych, kolekcjach i dokumentach.

Uwaga / Notatka

Przykładowe fragmenty kodu są dostępne w witrynie GitHub jako projekt JavaScript.

Dokumentacja referencyjna interfejsu API dla MongoDB | Pakiet MongoDB (npm)

Prerequisites

Konto platformy Azure z aktywną subskrypcją. Utwórz bezpłatne konto.
Node.js LTS
Azure Command-Line Interface (CLI) lub Azure PowerShell
Zasób usługi Azure Cosmos DB dla bazy danych MongoDB

Tworzenie nowej aplikacji JavaScript

Utwórz nową aplikację JavaScript w pustym folderze przy użyciu preferowanego terminalu. Użyj polecenia npm init, aby uruchomić monity do utworzenia pliku package.json. Zaakceptuj wartości domyślne dla monitów.
```
npm init
```
Dodaj pakiet npm bazy danych MongoDB do projektu JavaScript. npm install package Użyj polecenia określającego nazwę pakietu npm. Pakiet dotenv służy do odczytywania zmiennych środowiskowych z .env pliku podczas lokalnego tworzenia oprogramowania.
```
npm install mongodb dotenv
```
Aby uruchomić aplikację, użyj terminalu, aby przejść do katalogu aplikacji i uruchomić aplikację.
```
node index.js
```

Łączenie się z bazą danych Azure Cosmos DB dla MongoDB przy użyciu natywnego sterownika MongoDB

Aby nawiązać połączenie ze sterownikiem natywnym MongoDB do usługi Azure Cosmos DB, utwórz wystąpienie klasy MongoClient. Ta klasa jest punktem wyjścia do wykonywania wszystkich operacji względem baz danych.

Najczęściej używany konstruktor MongoClient ma dwa parametry:

Parameter	Przykładowa wartość	Description
`url`	`COSMOS_CONNECTION_STRING` zmienna środowiskowa	Interfejs API dla bazy danych MongoDB parametry połączenia do użycia dla wszystkich żądań
`options`	`{ssl: true, tls: true, }`	Opcje bazy danych MongoDB dla połączenia.

Zapoznaj się z przewodnikiem rozwiązywania problemów z połączeniem.

Uzyskiwanie nazwy zasobu

Utwórz zmienną powłoki dla resourceGroupName.

# Variable for resource group name
resourceGroupName="msdocs-cosmos"

Użyj polecenia az cosmosdb list, aby pobrać nazwę pierwszego konta usługi Azure Cosmos DB w grupie zasobów i zapisać je w zmiennej powłoki accountName.

# Retrieve most recently created account name
accountName=$(
    az cosmosdb list \
        --resource-group $resourceGroupName \
        --query "[0].name" \
        --output tsv
)

Utwórz zmienną powłoki dla RESOURCE_GROUP_NAME.

# Variable for resource group name
$RESOURCE_GROUP_NAME = "msdocs-cosmos"

Użyj polecenia cmdlet Get-AzCosmosDBAccountKey, aby pobrać nazwę pierwszego konta usługi Azure Cosmos DB w grupie zasobów i zapisać je w zmiennej powłoki accountName.
```
# Get the name of the first Azure Cosmos DB account in your resource group
$ACCOUNT_NAME = (Get-AzCosmosDBAccount -ResourceGroupName $RESOURCE_GROUP_NAME)[0].Name
```

Pobieranie parametrów połączenia

Znajdź API dla MongoDB parametrów połączenia z listy parametrów połączenia dla konta za pomocą polecenia az cosmosdb keys list.
```
az cosmosdb keys list --type connection-strings \
    --resource-group $resourceGroupName \
    --name $accountName 
```
Zapisz wartości KLUCZA GŁÓWNEGO. Będziesz używać tych danych logowania później.

Znajdź CIĄG POŁĄCZENIA z listy kluczy i ciągów połączenia dla konta przy użyciu polecenia Get-AzCosmosDBAccountKey cmdlet.

$parameters = @{
    ResourceGroupName = $RESOURCE_GROUP_NAME
    Name = $ACCOUNT_NAME
    Type = "ConnectionStrings"
}    
Get-AzCosmosDBAccountKey @parameters |
    Select-Object -Property "Primary MongoDB Connection String"

Zarejestruj wartość ŁAŃCUCHA POŁĄCZENIA. Będziesz używać tych danych logowania później.

Wskazówka

W tym przewodniku zalecamy użycie nazwy msdocs-cosmosgrupy zasobów .

Zaloguj się do portalu Azure.
Przejdź do istniejącej strony konta usługi Azure Cosmos DB dla bazy danych MongoDB.
Na stronie konta usługi Azure Cosmos DB dla MongoDB wybierz opcję Łańcuch połączenia.
Zapisz wartość pola PODSTAWOWE PARAMETRY POŁĄCZENIA. Ta wartość jest używana w późniejszym kroku.

Konfigurowanie zmiennych środowiskowych

Aby użyć wartości CIĄGU POŁĄCZENIA w kodzie, ustaw tę wartość w środowisku lokalnym, w którym uruchomiono aplikację. Aby ustawić zmienną środowiskową, użyj preferowanego terminalu, aby uruchomić następujące polecenia:

$env:COSMOS_CONNECTION_STRING = "<cosmos-connection-string>"

export COSMOS_CONNECTION_STRING="<cosmos-connection-string>"

.env Plik to standardowy sposób przechowywania zmiennych środowiskowych w projekcie. Utwórz plik .env w katalogu głównym projektu. Dodaj następujące wiersze do .env pliku:

COSMOS_CONNECTION_STRING="<cosmos-connection-string>"

Tworzenie elementu MongoClient przy użyciu parametry połączenia

Dodaj zależności, aby odwoływać się do pakietów npm mongoDB i DotEnv.

// Use official mongodb driver to connect to the server
import { MongoClient } from 'mongodb';

Zdefiniuj nowe wystąpienie klasy MongoClient przy użyciu konstruktora, oraz użyj ciągu połączenia process.env..

// New instance of MongoClient with connection string
// for Cosmos DB
const url = process.env.COSMOS_CONNECTION_STRING;
const client = new MongoClient(url);

// connect to the server
await client.connect();

// client options
const options = client.options;
console.log(
  `Options:\n${Object.keys(options).map(key => `\t${key}: ${options[key]}\n`)}`
);

Aby uzyskać więcej informacji na temat różnych sposobów tworzenia wystąpienia MongoClient, zobacz Szybki start przewodnika sterownika NodeJS MongoDB.

Zamykanie połączenia z klientem MongoClient

Po zakończeniu pracy aplikacji z połączeniem pamiętaj, aby ją zamknąć. Wywołanie .close() powinno być wykonywane po wszystkich wywołaniach bazy danych.

client.close()

Używaj klas klientów MongoDB z usługą Azure Cosmos DB dla API MongoDB

Przed rozpoczęciem tworzenia aplikacji przyjrzyjmy się hierarchii zasobów w usłudze Azure Cosmos DB. Usługa Azure Cosmos DB ma określony model obiektów używany do tworzenia zasobów i uzyskiwania do ich dostępu. Usługa Azure Cosmos DB tworzy zasoby w hierarchii składającej się z kont, baz danych, kolekcji i dokumentów.

Diagram hierarchii usługi Azure Cosmos DB dla bazy danych MongoDB, w tym kont, baz danych, kolekcji i dokumentów.

Każdy typ zasobu jest reprezentowany przez co najmniej jedną skojarzną klasę języka JavaScript. Oto lista najpopularniejszych klas:

Class	Description
`MongoClient`	Ta klasa zapewnia logiczną reprezentację po stronie klienta dla warstwy interfejsu API MongoDB w usłudze Azure Cosmos DB. Obiekt klienta służy do konfigurowania i wykonywania żądań względem usługi.
`Db`	Ta klasa jest odwołaniem do bazy danych, która może lub nie istnieje jeszcze w usłudze. Baza danych jest weryfikowana po stronie serwera podczas próby uzyskania do niej dostępu lub wykonania na niej operacji.
`Collection`	Ta klasa jest odwołaniem do kolekcji, która również może jeszcze nie istnieć w usłudze. Kolekcja jest weryfikowana po stronie serwera podczas próby pracy z nią.

W poniższych przewodnikach pokazano, jak utworzyć aplikację przy użyciu każdej z tych klas.

Przewodnik:

Zobacz także

Następne kroki

Po nawiązaniu połączenia z interfejsem API dla konta MongoDB, następnie skorzystaj z przewodnika, aby tworzyć i zarządzać bazami danych.

Tworzenie bazy danych w usłudze Azure Cosmos DB dla bazy danych MongoDB przy użyciu języka JavaScript

Opinia

Czy ta strona była pomocna?

Last updated on 2026-04-27