مشاركة عبر

StoredProcedures class

الحزمة:
@azure/cosmos

عمليات إنشاء أو رفع أو قراءة/الاستعلام عن كافة الإجراءات المخزنة.

لعمليات قراءة إجراء مخزن محدد موجود أو استبداله أو حذفه أو تنفيذه حسب المعرف، راجع container.storedProcedure().

الخصائص

container

الأساليب

create(StoredProcedureDefinition, RequestOptions)

إنشاء StoredProcedure.

يسمح Azure Cosmos DB بتنفيذ الإجراءات المخزنة في طبقة التخزين، مباشرة مقابل حاوية عنصر. يتم تنفيذ البرنامج النصي ضمن معاملات ACID على قسم التخزين الأساسي للحاوية المحددة. للحصول على تفاصيل إضافية، راجع وثائق واجهة برمجة تطبيقات JavaScript من جانب الخادم.

المثال

import { CosmosClient, StoredProcedureDefinition } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const sprocDefinition: StoredProcedureDefinition = {
  id: "sample sproc",
  body: "function () { const x = 10; }",
};

const { resource: sproc } = await container.scripts.storedProcedures.create(sprocDefinition);
query(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الإجراءات المخزنة.

المثال

اقرأ جميع الإجراءات المخزنة إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @sproc`,
  parameters: [{ name: "@sproc", value: "Todo" }],
};
const { resources: storedProceduresList } = await container.scripts.storedProcedures
  .query(querySpec)
  .fetchAll();
query<T>(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الإجراءات المخزنة.

المثال

اقرأ جميع الإجراءات المخزنة إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @sproc`,
  parameters: [{ name: "@sproc", value: "Todo" }],
};
const { resources: storedProceduresList } = await container.scripts.storedProcedures
  .query(querySpec)
  .fetchAll();
readAll(FeedOptions)

اقرأ جميع الإجراءات المخزنة.

المثال

اقرأ جميع الإجراءات المخزنة إلى صفيف.

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const { resources: storedProceduresList } = await container.scripts.storedProcedures
  .readAll()
  .fetchAll();

تفاصيل الخاصية

container 

container: Container

قيمة الخاصية

Container

تفاصيل الأسلوب

create(StoredProcedureDefinition, RequestOptions)

إنشاء StoredProcedure.

يسمح Azure Cosmos DB بتنفيذ الإجراءات المخزنة في طبقة التخزين، مباشرة مقابل حاوية عنصر. يتم تنفيذ البرنامج النصي ضمن معاملات ACID على قسم التخزين الأساسي للحاوية المحددة. للحصول على تفاصيل إضافية، راجع وثائق واجهة برمجة تطبيقات JavaScript من جانب الخادم.

المثال

import { CosmosClient, StoredProcedureDefinition } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });
const { database } = await client.databases.createIfNotExists({ id: "Test Database" });
const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const sprocDefinition: StoredProcedureDefinition = {
  id: "sample sproc",
  body: "function () { const x = 10; }",
};

const { resource: sproc } = await container.scripts.storedProcedures.create(sprocDefinition);

function create(body: StoredProcedureDefinition, options?: RequestOptions): Promise<StoredProcedureResponse>

المعلمات

body
StoredProcedureDefinition
options
RequestOptions

المرتجعات

Promise<StoredProcedureResponse>

query(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الإجراءات المخزنة.

المثال

اقرأ جميع الإجراءات المخزنة إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @sproc`,
  parameters: [{ name: "@sproc", value: "Todo" }],
};
const { resources: storedProceduresList } = await container.scripts.storedProcedures
  .query(querySpec)
  .fetchAll();

function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

المعلمات

query
SqlQuerySpec

تكوين الاستعلام للعملية. راجع SqlQuerySpec لمزيد من المعلومات حول كيفية تكوين استعلام.

options
FeedOptions

المرتجعات

QueryIterator<any>

query<T>(SqlQuerySpec, FeedOptions)

الاستعلام عن كافة الإجراءات المخزنة.

المثال

اقرأ جميع الإجراءات المخزنة إلى صفيف.

import { CosmosClient, SqlQuerySpec } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @sproc`,
  parameters: [{ name: "@sproc", value: "Todo" }],
};
const { resources: storedProceduresList } = await container.scripts.storedProcedures
  .query(querySpec)
  .fetchAll();

function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

المعلمات

query
SqlQuerySpec

تكوين الاستعلام للعملية. راجع SqlQuerySpec لمزيد من المعلومات حول كيفية تكوين استعلام.

options
FeedOptions

المرتجعات

QueryIterator<T>

readAll(FeedOptions)

اقرأ جميع الإجراءات المخزنة.

المثال

اقرأ جميع الإجراءات المخزنة إلى صفيف.

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const { resources: storedProceduresList } = await container.scripts.storedProcedures
  .readAll()
  .fetchAll();

function readAll(options?: FeedOptions): QueryIterator<StoredProcedureDefinition & Resource>

المعلمات

options
FeedOptions

المرتجعات

QueryIterator<StoredProcedureDefinition & Resource>