Halaman ini memperlihatkan metode dan klien autentikasi yang didukung, dan menampilkan kode sampel yang dapat Anda gunakan untuk menyambungkan kluster MongoDB Atlas dari layanan komputasi Azure menggunakan Konektor Layanan. Anda mungkin masih dapat terhubung ke kluster MongoDB Atlas dalam bahasa pemrograman lain tanpa menggunakan Konektor Layanan. Halaman ini juga menampilkan nama dan nilai variabel lingkungan default yang Anda dapatkan saat membuat koneksi layanan.
Layanan komputasi yang didukung
Konektor Layanan dapat digunakan untuk menghubungkan layanan komputasi berikut ke kluster MongoDB Atlas:
- Azure App Service
- Aplikasi Kontainer Azure
- Fungsi Azure
- Azure Kubernetes Service (AKS)
Jenis Autentikasi yang Didukung serta jenis klien
Tabel di bawah ini menunjukkan kombinasi metode autentikasi dan klien mana yang didukung untuk menghubungkan layanan komputasi Anda ke kluster MongoDB Atlas menggunakan Konektor Layanan. "Ya" menunjukkan bahwa kombinasi didukung, sementara "Tidak" menunjukkan bahwa kombinasi tersebut tidak didukung.
| Jenis klien |
Identitas terkelola yang diberikan oleh sistem |
Identitas terkelola yang ditetapkan pengguna |
Rahasia atau string koneksi |
Principal layanan |
| .JARING |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Pergi (pg) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Java (JDBC) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Java - Spring Boot (JDBC) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Node.js (pg) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| PHP (asli) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Python (psycopg2) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Python-Django |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Ruby (ruby-pg) |
Tidak. |
Tidak. |
Ya |
Tidak. |
| Tidak ada |
Tidak. |
Tidak. |
Ya |
Tidak. |
Nama variabel lingkungan default atau properti aplikasi dan kode sampel
Referensikan detail koneksi dan kode sampel dalam tabel berikut, sesuai dengan jenis autentikasi koneksi dan jenis klien Anda, untuk menyambungkan layanan komputasi ke kluster MongoDB Atlas. Untuk informasi selengkapnya tentang konvensi penamaan, periksa artikel mengenai pengoperasian Konektor Layanan.
String Koneksi
Peringatan
Microsoft menyarankan agar Anda menggunakan alur autentikasi paling aman yang tersedia. Alur autentikasi yang dijelaskan dalam prosedur ini membutuhkan tingkat kepercayaan yang sangat tinggi pada aplikasi, dan membawa risiko yang tidak ada dalam alur lain. Anda hanya boleh menggunakan alur ini ketika alur lain yang lebih aman, seperti identitas terkelola, tidak layak.
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi .NET pada MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi JDBC MongoDB Atlas |
jdbc:mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi Python MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi Django MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi MongoDB Atlas untuk Go |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String Koneksi NodeJS ke MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi MongoDB Atlas bawaan PHP |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi Ruby MongoDB Atlas |
mongodb+srv:/<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
| Nama Variabel Lingkungan Standar |
Deskripsi |
Contoh nilai |
MONGODBATLAS_CLUSTER_CONNECTIONSTRING |
String koneksi MongoDB Atlas |
mongodb+srv://<database-username>:<database-password>@<cluster-URL>/?retryWrites=true&w=majority&appName=Cluster0 |
Contoh kode
Lihat langkah-langkah dan kode di bawah ini untuk menyambungkan ke kluster MongoDB Atlas menggunakan string koneksi.
Instal dependensi.
dotnet add package MongoDb.Driver
Dapatkan string koneksi dari variabel lingkungan yang ditambahkan oleh Konektor Layanan dan sambungkan ke MongoDB Atlas.
using MongoDB.Driver;
var connectionString = Environment.GetEnvironmentVariable("MONGODBATLAS_CLUSTER_CONNECTIONSTRING");
var client = new MongoClient(connectionString);
Tambahkan dependensi berikut dalam file pom.xml Anda:
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongo-java-driver</artifactId>
<version>3.4.2</version>
</dependency>
Dapatkan string koneksi dari variabel lingkungan yang ditambahkan oleh Konektor Layanan dan sambungkan ke MongoDB Atlas.
import com.mongodb.MongoClient;
import com.mongodb.MongoClientURI;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Filters;
String connectionString = System.getenv("MONGODBATLAS_CLUSTER_CONNECTIONSTRING");
MongoClientURI uri = new MongoClientURI(connectionString);
MongoClient mongoClient = null;
try {
mongoClient = new MongoClient(uri);
} finally {
if (mongoClient != null) {
mongoClient.close();
}
}
Instal dependensi.
pip install pymongo
Dapatkan string koneksi dari variabel lingkungan yang ditambahkan oleh Konektor Layanan dan sambungkan ke MongoDB Atlas.
import os
import pymongo
conn_str = os.environ.get("MONGODBATLAS_CLUSTER_CONNECTIONSTRING")
client = pymongo.MongoClient(conn_str)
- Instal dependensi.
go get go.mongodb.org/mongo-driver/mongo
- Dapatkan string koneksi dari variabel lingkungan yang ditambahkan oleh Konektor Layanan dan sambungkan ke MongoDB Atlas.
import (
"context"
"fmt"
"log"
"os"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
ctx, cancel := context.WithTimeout(context.Background(), time.Second*10)
defer cancel()
mongoDBConnectionString = os.Getenv("MONGODBATLAS_CLUSTER_CONNECTIONSTRING")
clientOptions := options.Client().ApplyURI(mongoDBConnectionString).SetDirect(true)
c, err := mongo.Connect(ctx, clientOptions)
if err != nil {
log.Fatalf("unable to initialize connection %v", err)
}
err = c.Ping(ctx, nil)
if err != nil {
log.Fatalf("unable to connect %v", err)
}
- Instal dependensi.
npm install mongodb
- Dapatkan string koneksi dari variabel lingkungan yang ditambahkan oleh Konektor Layanan dan sambungkan ke MongoDB Atlas.
const { MongoClient, ObjectId } = require('mongodb');
const url = process.env.MONGODBATLAS_CLUSTER_CONNECTIONSTRING;
const client = new MongoClient(url);
Untuk bahasa lain, Anda dapat menggunakan endpoint sumber daya MongoDB dan properti lain yang ditetapkan oleh Konektor Layanan pada variabel lingkungan untuk menyambungkan ke MongoDB Atlas. Untuk detail variabel lingkungan, lihat Mengintegrasikan MongoDB dengan Konektor Layanan.
Langkah selanjutnya
Ikuti tutorial yang tercantum di bawah ini untuk mempelajari lebih lanjut tentang Konektor Layanan.