Users class

الحزمة:

@azure/cosmos

يستخدم لإنشاء جميع المستخدمين وتكبيرهم والاستعلام عن بياناتهم وقراءتها.

راجع المستخدم لقراءة مستخدم معين أو استبداله أو حذفه حسب المعرف.

الخصائص

database

الأساليب

create(UserDefinition, RequestOptions)	إنشاء مستخدم قاعدة بيانات مع UserDefinition المحدد. المثال 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" }); await database.users.create({ id: "<user-id>" });
query(SqlQuerySpec, FeedOptions)	استعلم عن جميع المستخدمين.
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 querySpec: SqlQuerySpec = { query: `SELECT * FROM root r WHERE r.id = @user`, parameters: [{ name: "@user", value: "<user-id>" }], }; const { resources: permisssion } = await database.users.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 { resources: usersList } = await database.users.readAll().fetchAll();
upsert(UserDefinition, RequestOptions)	Upsert مستخدم قاعدة بيانات مع محدد UserDefinition. المثال 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" }); await database.users.upsert({ id: "<user-id>" });

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

database

database: Database

قيمة الخاصية

Database

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

create(UserDefinition, RequestOptions)

إنشاء مستخدم قاعدة بيانات مع UserDefinition المحدد.

المثال

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" });

await database.users.create({ id: "<user-id>" });

function create(body: UserDefinition, options?: RequestOptions): Promise<UserResponse>

المعلمات

body

UserDefinition

تعريف المستخدمالمحدد .

options

RequestOptions

المرتجعات

Promise<UserResponse>

query(SqlQuerySpec, FeedOptions)

استعلم عن جميع المستخدمين.

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 querySpec: SqlQuerySpec = {
  query: `SELECT * FROM root r WHERE r.id = @user`,
  parameters: [{ name: "@user", value: "<user-id>" }],
};
const { resources: permisssion } = await database.users.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 { resources: usersList } = await database.users.readAll().fetchAll();

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

المعلمات

options

FeedOptions

المرتجعات

QueryIterator<UserDefinition & Resource>

upsert(UserDefinition, RequestOptions)

Upsert مستخدم قاعدة بيانات مع محدد UserDefinition.

المثال

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" });

await database.users.upsert({ id: "<user-id>" });

function upsert(body: UserDefinition, options?: RequestOptions): Promise<UserResponse>

المعلمات

body

UserDefinition

تعريف المستخدمالمحدد .

options

RequestOptions

المرتجعات

Promise<UserResponse>