@azure/cosmos package

Kesalahan ini dilemparkan ketika operasi asinkron telah dibatalkan. Periksa kesalahan ini dengan menguji name bahwa properti nama kesalahan cocok "AbortError".

Contoh

const controller = new AbortController();
controller.abort();
try {
  doAsyncWork(controller.signal)
} catch (e) {
  if (e.name === 'AbortError') {
    // handle abort error here.
  }
}

Menyediakan iterator untuk umpan perubahan.

Gunakan Items.changeFeed() untuk mendapatkan instans iterator.

Satu halaman respons dari Umpan Perubahan Azure Cosmos DB

Mewakili konfigurasi kebijakan umpan perubahan untuk kontainer di layanan Azure Cosmos DB.

Satu halaman respons dari Umpan Perubahan Azure Cosmos DB

Kelas dasar tempat memulai ChangeFeedIterator.

Gunakan untuk membaca atau menghapus Konflik yang diberikan menurut id.

Lihat Konflik untuk mengkueri atau membaca semua konflik.

Gunakan untuk mengkueri atau membaca semua konflik.

Lihat Konflik untuk membaca atau menghapus Konflik tertentu menurut id.

Operasi untuk membaca, mengganti, atau menghapus kontainer tertentu yang ada menurut id.

Lihat Kontainer untuk membuat kontainer baru, dan membaca/mengkueri semua kontainer; gunakan .containers.

Catatan: semua operasi ini melakukan panggilan terhadap anggaran tetap. Anda harus merancang sistem Anda sih sehingga panggilan ini menskalakan secara sublinear dengan aplikasi Anda. Misalnya, jangan memanggil container(id).read() sebelum setiap panggilan item.read(), untuk memastikan kontainer ada; lakukan ini setelah aplikasi dimulai.

Objek respons untuk operasi Kontainer

Operasi untuk membuat kontainer baru, dan membaca/mengkueri semua kontainer

Lihat Kontainer untuk membaca, mengganti, atau menghapus kontainer yang ada; gunakan .

Catatan: semua operasi ini melakukan panggilan terhadap anggaran tetap. Anda harus merancang sistem Anda sih sehingga panggilan ini menskalakan secara sublinear dengan aplikasi Anda. Misalnya, jangan memanggil containers.readAll() sebelum setiap panggilan item.read(), untuk memastikan kontainer ada; lakukan ini setelah aplikasi dimulai.

Menyediakan representasi logis sisi klien dari akun database Azure Cosmos DB. Klien ini digunakan untuk mengonfigurasi dan menjalankan permintaan di layanan database Azure Cosmos DB.

Contoh

Membuat instans klien dan membuat database baru

const client = new CosmosClient({endpoint: "<URL HERE>", key: "<KEY HERE>"});
await client.databases.create({id: "<database name here>"});

Contoh

Membuat instans klien dengan Kebijakan Koneksi kustom

const client = new CosmosClient({
   endpoint: "<URL HERE>",
   key: "<KEY HERE>",
   connectionPolicy: {
    requestTimeout: 10000,
   },
});

• Ini adalah jenis Diagnostik Cosmos yang menyimpan informasi diagnostik yang dikumpulkan selama operasi klien. Ie. Item.read(), Container.create(). Ini memiliki tiga anggota -

1. clientSideRequestStatistics anggota berisi informasi diagnostik agregat, termasuk -

• pencarian metadata. Di sini semua permintaan server, selain dari sumber daya yang dimaksudkan akhir dianggap sebagai panggilan metadata. yaitu untuk item.read(id), jika klien melakukan panggilan server untuk menemukan titik akhir, itu akan dianggap sebagai panggilan metadata.
• Pengulangan
• titik akhir dihubungi.
• permintaan, statistik payload respons.
• gatewayStatistics - Informasi yang sesuai dengan operasi utama. Misalnya selama Item.read(), klien mungkin melakukan banyak operasi yaitu pencarian metadata dll, tetapi gatewayStatistics mewakili informasi diagnostik untuk operasi baca aktual.

2. diagnosticNode - Adalah pohon seperti struktur yang menangkap informasi diagnostik terperinci. Secara default dinonaktifkan, dan dimaksudkan untuk digunakan hanya untuk penelusuran kesalahan pada lingkungan non produksi. Jenis detail yang diambil dalam diagnosticNode dikendalikan oleh CosmosDbDiagnosticLevel.

• CosmosDbDiagnosticLevel.info - Adalah nilai default. Dalam tingkat ini hanya clientSideRequestStatistics yang ditangkap. Dimaksudkan untuk lingkungan produksi.
• CosmosDbDiagnosticLevel.debug - Menangkap diagnostikNode dan clientConfig. Tidak ada payload permintaan dan respons yang ditangkap. Tidak dimaksudkan untuk digunakan di lingkungan produksi.
• CosmosDbDiagnosticLevel.debug-unsafe - Selain data yang diambil di CosmosDbDiagnosticLevel.debug, juga menangkap payload permintaan dan respons. Tidak dimaksudkan untuk digunakan di lingkungan produksi.

3. clientConfig - Menangkap informasi yang terkait dengan bagaimana klien dikonfigurasi selama inisialisasi.

Operasi untuk membaca atau menghapus database yang sudah ada.

Lihat Database untuk membuat database baru, dan membaca/mengkueri semua database; gunakan client.databases.

Catatan: semua operasi ini melakukan panggilan terhadap anggaran tetap. Anda harus merancang sistem Anda sih sehingga panggilan ini menskalakan secara sublinear dengan aplikasi Anda. Misalnya, jangan memanggil database.read() sebelum setiap panggilan item.read(), untuk memastikan database ada; lakukan ini setelah aplikasi dimulai.

Mewakili DatabaseAccount di layanan database Azure Cosmos DB.

Objek respons untuk operasi Database

Operasi untuk membuat database baru, dan membaca/mengkueri semua database

Lihat Database untuk membaca atau menghapus database yang sudah ada; gunakan .

Catatan: semua operasi ini melakukan panggilan terhadap anggaran tetap. Anda harus merancang sistem Anda sih sehingga panggilan ini menskalakan secara sublinear dengan aplikasi Anda. Misalnya, jangan memanggil databases.readAll() sebelum setiap panggilan item.read(), untuk memastikan database ada; lakukan ini setelah aplikasi dimulai.

Menentukan rentang umpan untuk umpan perubahan.

Digunakan untuk melakukan operasi pada item tertentu.

Lihat Item untuk operasi pada semua item; lihat .

Operasi untuk membuat item baru, dan membaca/mengkueri semua item

Lihat Item untuk membaca, mengganti, atau menghapus kontainer yang ada; gunakan .

Gunakan untuk membaca atau mengganti Penawaran yang ada berdasarkan id.

Lihat Penawaran untuk mengkueri atau membaca semua penawaran.

Gunakan untuk mengkueri atau membaca semua Penawaran.

Lihat Penawaran untuk membaca atau mengganti Penawaran yang ada berdasarkan id.

Kelas penyusun untuk membangun PartitionKey.

Gunakan untuk membaca, mengganti, atau menghapus izin yang diberikan menurut id.

Lihat Izin untuk membuat, meningkatkan, mengkueri, atau membaca semua Izin.

Gunakan untuk membuat, mengganti, mengkueri, dan membaca semua Izin.

Lihat Izin untuk membaca, mengganti, atau menghapus izin tertentu berdasarkan id.

Mewakili Objek QueryIterator, implementasi umpan atau respons kueri yang memungkinkan traversal dan iterasi atas respons dalam layanan database Azure Cosmos DB.

Jenis kesalahan kustom untuk permintaan alur yang gagal.

Operasi untuk membaca, mengganti, menghapus, atau menjalankan prosedur tersimpan tertentu yang ada berdasarkan id.

Agar operasi membuat, membaca semua, atau mengkueri Prosedur Tersimpan,

Operasi untuk membuat, meningkatkan, atau membaca/mengkueri semua Prosedur Tersimpan.

Agar operasi membaca, mengganti, menghapus, atau menjalankan prosedur tersimpan tertentu yang ada menurut id, lihat container.storedProcedure().

Operasi untuk membaca, mengganti, atau menghapusPemicu .

Gunakan container.triggers untuk membuat, meningkatkan, mengkueri, atau membaca semua.

Operasi untuk membuat, meningkatkan, mengkueri, dan membaca semua pemicu.

Gunakan untuk membaca, mengganti, atau menghapusPemicu .

Digunakan untuk membaca, mengganti, dan menghapus Pengguna.

Selain itu, Anda dapat mengakses izin untuk pengguna tertentu melalui user.permission dan user.permissions.

Lihat Pengguna untuk membuat, melakukan upsert, mengkueri, atau membaca semua.

Digunakan untuk membaca, mengganti, atau menghapus Fungsi Definied Pengguna tertentu berdasarkan id.

Lihat userDefinedFunction untuk membuat, upsert, kueri, membaca semua Fungsi yang Ditentukan Pengguna.

Digunakan untuk membuat, meningkatkan, mengkueri, atau membaca semua Fungsi yang Ditentukan Pengguna.

Lihat UserDefinedFunction untuk membaca, mengganti, atau menghapus Fungsi yang Ditentukan Pengguna berdasarkan id tertentu.

Digunakan untuk membuat, meningkatkan, mengkueri, dan membaca semua pengguna.

Lihat Pengguna untuk membaca, mengganti, atau menghapus Pengguna tertentu berdasarkan id.

Objek opsi yang digunakan untuk mengubah eksekusi massal. continueOnError (Nilai default: false) - Melanjutkan eksekusi massal ketika operasi gagal ** PERHATIKAN INI AKAN DEFAULT KE TRUE DALAM RILIS 4.0

Menentukan opsi untuk umpan perubahan

Jika tidak ada opsi tersebut yang diatur, opsi tersebut akan mulai membaca perubahan dari sekarang untuk seluruh kontainer.

Menentukan opsi untuk umpan perubahan

Beberapa opsi ini mengontrol di mana dan kapan harus mulai membaca dari umpan perubahan. Urutan prioritas adalah:

• Kelanjutan
• startTime
• startFromBeginning

Jika tidak ada opsi tersebut yang diatur, opsi tersebut akan mulai membaca perubahan dari panggilan ChangeFeedIterator.fetchNext() pertama.

Gunakan Items.getChangeFeedIterator() untuk mengembalikan iterator yang dapat melakukan iterasi atas semua perubahan untuk kunci partisi, rentang umpan, atau seluruh kontainer.

Mewakili jalur komposit dalam kebijakan pengindeksan.

Mewakili konfigurasi kebijakan resolusi konflik untuk menentukan cara mengatasi konflik jika penulisan dari berbagai wilayah mengakibatkan konflik pada dokumen dalam koleksi di layanan Azure Cosmos DB.

Mewakili kebijakan Koneksi yang terkait dengan CosmosClient dalam layanan database Azure Cosmos DB.

Mewakili pohon seperti struktur, untuk menangkap informasi diagnostik.

Jenis ini menangkap informasi diagnostik mengenai permintaan yang gagal ke api server.

Opsi umpan dan metode kueri.

Mewakili indeks teks lengkap dalam kebijakan pengindeksan.

Mewakili jalur teks lengkap yang akan diindeks dalam layanan Azure Cosmos DB.

Mewakili kebijakan teks lengkap untuk koleksi di layanan Azure Cosmos DB.

Item di Cosmos DB hanyalah objek JSON. Sebagian besar operasi Item memungkinkan Anda untuk menyediakan jenis Anda sendiri yang memperluas ItemDefinisi yang sangat sederhana.

Anda tidak dapat menggunakan kunci yang dipesan. Anda dapat melihat daftar kunci yang dipesan di <xref:ItemBody>

Digunakan untuk menentukan lokasi yang tersedia, baca adalah indeks 1 dan tulis adalah indeks 0.

Jenis ini berisi informasi diagnostik mengenai satu permintaan metadata ke server.

Opsi yang dapat ditentukan untuk permintaan yang dikeluarkan ke server Azure Cosmos DB.=

Mewakili kebijakan Coba Lagi yang dialokasikan dengan permintaan yang dibatasi dalam layanan database Azure Cosmos DB.

Opsi yang dapat ditentukan untuk permintaan yang dikeluarkan ke server Azure Cosmos DB.=

Mewakili parameter dalam kueri SQL Berparameter, yang ditentukan dalam SqlQuerySpec

Mewakili kueri SQL di layanan Azure Cosmos DB.

Kueri dengan input harus diparameterkan untuk melindungi dari injeksi SQL.

Contoh

Kueri SQL Berparameter

const query: SqlQuerySpec = {
  query: "SELECT * FROM Families f where f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Wakefield"}
  ]
};

Antarmuka untuk satu kunci unik yang diteruskan sebagai bagian dari UniqueKeyPolicy

Antarmuka untuk mengatur kunci unik pada pembuatan kontainer

Mewakili penyematan vektor. Penyematan vektor digunakan untuk menentukan bidang vektor dalam dokumen.

Mewakili konfigurasi kebijakan untuk penyematan vektor di layanan Azure Cosmos DB.

Mewakili indeks vektor dalam layanan Azure Cosmos DB. Indeks vektor digunakan untuk mengindeks bidang vektor dalam dokumen.

Jenis ini menyimpan informasi yang terkait dengan inisialisasi CosmosClient

Ini adalah jenis koleksi untuk semua informasi diagnostik sisi klien.

Jenis ini berisi informasi diagnostik mengenai semua permintaan metadata ke server selama operasi klien CosmosDB.

Objek yang dikembalikan mewakili nilai kunci partisi yang memungkinkan pembuatan dan akses item tanpa nilai untuk kunci partisi

Objek yang dikembalikan mewakili nilai kunci partisi yang memungkinkan pembuatan dan akses item dengan nilai null untuk kunci partisi.

PartitionKey dari kontainer.

Nilai Kunci Partisi primitif.

Jenis ini menangkap informasi diagnostik mengenai upaya percobaan ulang selama operasi klien CosmosDB.

Menentukan perilaku koneksi CosmosClient. Catatan, saat ini kami hanya mendukung Mode Gateway.

Mewakili tingkat konsistensi yang didukung untuk operasi klien Azure Cosmos DB.
ConsistencyLevel yang diminta harus cocok atau lebih lemah dari yang disediakan untuk akun database. Tingkat konsistensi.

Tingkat konsistensi berdasarkan urutan kekuatan adalah Kuat, BoundedStaleness, Sesi, Awalan Konsisten, dan Akhir.

Lihat https://aka.ms/cosmos-consistency untuk dokumentasi lebih rinci tentang Tingkat Konsistensi.

Tingkat Diagnostik Cosmos DB

Menentukan jenis data target dari spesifikasi jalur indeks di layanan Azure Cosmos DB.

Menentukan jenis Indeks yang didukung.

Menentukan mode pengindeksan yang didukung.

Ini enum untuk Jenis pencarian Metadata yang mungkin.

Versi Definisi PartitionKey

Jenis PartitionKey yaitu Hash, MultiHash

Enum untuk nilai mode izin.

Mewakili Tingkat Prioritas yang terkait dengan setiap permintaan klien Azure Cosmos DB.
Permintaan Prioritas rendah selalu dibatasi sebelum permintaan Prioritas tinggi.

Secara default semua permintaan dianggap sebagai Permintaan prioritas tinggi.

Lihat https://aka.ms/CosmosDB/PriorityBasedExecution untuk dokumentasi lebih rinci tentang pembatasan berbasis Prioritas.

Enum untuk nilai operasi pemicu. menentukan operasi tempat pemicu harus dijalankan.

Enum untuk nilai jenis pemicu. Menentukan jenis pemicu.

Enum untuk nilai jenis udf. Menentukan jenis fungsi yang ditentukan pengguna.

Mewakili jenis data vektor.

Mewakili fungsi jarak yang akan digunakan untuk perhitungan jarak di antara vektor.

Mewakili jenis indeks vektor.

Internal eksperimental hanya Menghasilkan payload yang mewakili konfigurasi izin untuk token sas.