مشاركة عبر

TableClient class

الحزمة:
@azure/data-tables

يمثل TableClient عميلا لخدمة Azure Tables مما يسمح لك بتنفيذ العمليات على جدول واحد.

المنشئون

TableClient(string, string, NamedKeyCredential, TableServiceClientOptions)

إنشاء مثيل جديد لفئة TableClient.
TableClient(string, string, SASCredential, TableServiceClientOptions)

إنشاء مثيل جديد لفئة TableClient.
TableClient(string, string, TableServiceClientOptions)

إنشاء مثيل TableClient.
TableClient(string, string, TokenCredential, TableServiceClientOptions)

إنشاء مثيل جديد لفئة TableClient.

الخصائص

pipeline

يمثل مسارا لإجراء طلب HTTP إلى عنوان URL. يمكن أن يكون للبنية الأساسية لبرنامج ربط العمليات التجارية نهج متعددة لإدارة معالجة كل طلب قبل وبعد تقديمه إلى الخادم.
tableName

اسم الجدول الذي تريد تنفيذ العمليات عليه.
url

عنوان URL لحساب الجدول

الأساليب

createEntity<T>(TableEntity<T>, OperationOptions)

إدراج كيان في الجدول.
createTable(OperationOptions)

إنشاء جدول باستخدام tableName الذي تم تمريره إلى الدالة الإنشائية للعميل
deleteEntity(string, string, DeleteTableEntityOptions)

حذف الكيان المحدد في الجدول.
deleteTable(OperationOptions)

حذف الجدول الحالي بشكل دائم مع جميع الكيانات الخاصة به.
fromConnectionString(string, string, TableServiceClientOptions)

إنشاء مثيل TableClient من سلسلة الاتصال.
getAccessPolicy(OperationOptions)

استرداد تفاصيل حول أي نهج وصول مخزنة محددة في الجدول والتي يمكن استخدامها مع توقيعات الوصول المشترك.
getEntity<T>(string, string, GetTableEntityOptions)

إرجاع كيان واحد في الجدول.
listEntities<T>(ListTableEntitiesOptions)

الاستعلام عن الكيانات في جدول.
setAccessPolicy(SignedIdentifier[], OperationOptions)

تعيين نهج الوصول المخزنة للجدول الذي يمكن استخدامه مع توقيعات الوصول المشترك.
submitTransaction(TransactionAction[], OperationOptions)

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

مثال على الاستخدام:

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient, TransactionAction } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const actions: TransactionAction[] = [
  ["create", { partitionKey: "p1", rowKey: "1", data: "test1" }],
  ["delete", { partitionKey: "p1", rowKey: "2" }],
  ["update", { partitionKey: "p1", rowKey: "3", data: "newTest" }, "Merge"],
];
const result = await client.submitTransaction(actions);

مثال على الاستخدام مع TableTransaction:

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient, TableTransaction } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const transaction = new TableTransaction();

// Call the available action in the TableTransaction object
transaction.createEntity({ partitionKey: "p1", rowKey: "1", data: "test1" });
transaction.deleteEntity("p1", "2");
transaction.updateEntity({ partitionKey: "p1", rowKey: "3", data: "newTest" }, "Merge");

// submitTransaction with the actions list on the transaction.
const result = await client.submitTransaction(transaction.actions);
updateEntity<T>(TableEntity<T>, UpdateMode, UpdateTableEntityOptions)

تحديث كيان في الجدول.
upsertEntity<T>(TableEntity<T>, UpdateMode, OperationOptions)

رفع كيان في الجدول.

تفاصيل المنشئ

TableClient(string, string, NamedKeyCredential, TableServiceClientOptions)

إنشاء مثيل جديد لفئة TableClient.

new TableClient(url: string, tableName: string, credential: NamedKeyCredential, options?: TableServiceClientOptions)

المعلمات

url

string

عنوان URL لحساب الخدمة الذي هو الهدف من العملية المطلوبة، مثل "https://myaccount.table.core.windows.net".

tableName

string

اسم الجدول

credential
NamedKeyCredential

يستخدم NamedKeyCredential لمصادقة الطلبات. معتمد فقط للعقدة

options
TableServiceClientOptions

اختياري. خيارات لتكوين البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.

مثال على استخدام اسم/مفتاح حساب:

import { AzureNamedKeyCredential, TableClient } from "@azure/data-tables";

// Enter your storage account name and shared key
const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

// Use AzureNamedKeyCredential with storage account and account key
// AzureNamedKeyCredential is only available in Node.js runtime, not in browsers
const credential = new AzureNamedKeyCredential(account, accountKey);
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

TableClient(string, string, SASCredential, TableServiceClientOptions)

إنشاء مثيل جديد لفئة TableClient.

new TableClient(url: string, tableName: string, credential: SASCredential, options?: TableServiceClientOptions)

المعلمات

url

string

عنوان URL لحساب الخدمة الذي هو الهدف من العملية المطلوبة، مثل "https://myaccount.table.core.windows.net".

tableName

string

اسم الجدول

credential
SASCredential

SASCredential المستخدم لمصادقة الطلبات

options
TableServiceClientOptions

اختياري. خيارات لتكوين البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.

مثال باستخدام رمز SAS المميز:

import { TableClient, AzureSASCredential } from "@azure/data-tables";

const account = "<account name>";
const sas = "<service Shared Access Signature Token>";
const tableName = "<tableName>";

const clientWithSAS = new TableClient(
  `https://${account}.table.core.windows.net`,
  tableName,
  new AzureSASCredential(sas),
);

TableClient(string, string, TableServiceClientOptions)

إنشاء مثيل TableClient.

new TableClient(url: string, tableName: string, options?: TableServiceClientOptions)

المعلمات

url

string

سلسلة عميل تشير إلى خدمة جدول تخزين Azure، مثل "https://myaccount.table.core.windows.net". يمكنك إلحاق SAS، مثل "https://myaccount.table.core.windows.net?sasString".

tableName

string

اسم الجدول

options
TableServiceClientOptions

خيارات لتكوين البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.

مثال إلحاق رمز SAS المميز:

import { TableClient } from "@azure/data-tables";

const account = "<account name>";
const sasToken = "<SAS token>";
const tableName = "<tableName>";

const clientWithSAS = new TableClient(
  `https://${account}.table.core.windows.net?${sasToken}`,
  tableName,
);

TableClient(string, string, TokenCredential, TableServiceClientOptions)

إنشاء مثيل جديد لفئة TableClient.

new TableClient(url: string, tableName: string, credential: TokenCredential, options?: TableServiceClientOptions)

المعلمات

url

string

عنوان URL لحساب الخدمة الذي هو الهدف من العملية المطلوبة، مثل "https://myaccount.table.core.windows.net".

tableName

string

اسم الجدول

credential
TokenCredential

بيانات اعتماد Azure Active Directory المستخدمة لمصادقة الطلبات

options
TableServiceClientOptions

اختياري. خيارات لتكوين البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.

مثال باستخدام بيانات اعتماد Azure Active Directory:

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const credential = new DefaultAzureCredential();
const account = "<account name>";
const tableName = "<tableName>";

const clientWithAAD = new TableClient(
  `https://${account}.table.core.windows.net`,
  tableName,
  credential,
);

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

pipeline

يمثل مسارا لإجراء طلب HTTP إلى عنوان URL. يمكن أن يكون للبنية الأساسية لبرنامج ربط العمليات التجارية نهج متعددة لإدارة معالجة كل طلب قبل وبعد تقديمه إلى الخادم.

pipeline: Pipeline

قيمة الخاصية

Pipeline

tableName

اسم الجدول الذي تريد تنفيذ العمليات عليه.

tableName: string

قيمة الخاصية

string

url

عنوان URL لحساب الجدول

url: string

قيمة الخاصية

string

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

createEntity<T>(TableEntity<T>, OperationOptions)

إدراج كيان في الجدول.

function createEntity<T>(entity: TableEntity<T>, options?: OperationOptions): Promise<TableInsertEntityHeaders>

المعلمات

entity

TableEntity<T>

خصائص كيان الجدول.

options
OperationOptions

معلمات الخيارات.

مثال على إنشاء كيان

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const testEntity = {
  partitionKey: "P1",
  rowKey: "R1",
  foo: "foo",
  bar: 123,
};
await client.createEntity(testEntity);

المرتجعات

Promise<TableInsertEntityHeaders>

createTable(OperationOptions)

إنشاء جدول باستخدام tableName الذي تم تمريره إلى الدالة الإنشائية للعميل

function createTable(options?: OperationOptions): Promise<void>

المعلمات

options
OperationOptions

معلمات الخيارات.

مثال على إنشاء جدول

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

// If the table 'newTable' already exists, createTable doesn't throw
await client.createTable();

المرتجعات

Promise<void>

deleteEntity(string, string, DeleteTableEntityOptions)

حذف الكيان المحدد في الجدول.

function deleteEntity(partitionKey: string, rowKey: string, options?: DeleteTableEntityOptions): Promise<TableDeleteEntityHeaders>

المعلمات

partitionKey

string

مفتاح القسم للكيان.

rowKey

string

مفتاح الصف للكيان.

options
DeleteTableEntityOptions

معلمات الخيارات.

مثال على حذف كيان

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

// deleteEntity deletes the entity that matches exactly the partitionKey and rowKey
await client.deleteEntity("<partitionKey>", "<rowKey>");

المرتجعات

Promise<TableDeleteEntityHeaders>

deleteTable(OperationOptions)

حذف الجدول الحالي بشكل دائم مع جميع الكيانات الخاصة به.

function deleteTable(options?: OperationOptions): Promise<void>

المعلمات

options
OperationOptions

معلمات الخيارات.

مثال على حذف جدول

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

await client.deleteTable();

المرتجعات

Promise<void>

fromConnectionString(string, string, TableServiceClientOptions)

إنشاء مثيل TableClient من سلسلة الاتصال.

static function fromConnectionString(connectionString: string, tableName: string, options?: TableServiceClientOptions): TableClient

المعلمات

connectionString

string

سلسلة اتصال الحساب أو سلسلة اتصال SAS لحساب تخزين Azure. [ ملاحظة - يمكن استخدام سلسلة اتصال الحساب فقط في وقت تشغيل NODE.JS. ] مثال سلسلة اتصال الحساب - DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net مثال سلسلة اتصال SAS - BlobEndpoint=https://myaccount.table.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString

tableName

string

options
TableServiceClientOptions

خيارات لتكوين البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.

المرتجعات

TableClient

TableClient جديد من سلسلة الاتصال المحددة.

getAccessPolicy(OperationOptions)

استرداد تفاصيل حول أي نهج وصول مخزنة محددة في الجدول والتي يمكن استخدامها مع توقيعات الوصول المشترك.

function getAccessPolicy(options?: OperationOptions): Promise<GetAccessPolicyResponse>

المعلمات

options
OperationOptions

معلمات الخيارات.

المرتجعات

Promise<GetAccessPolicyResponse>

getEntity<T>(string, string, GetTableEntityOptions)

إرجاع كيان واحد في الجدول.

function getEntity<T>(partitionKey: string, rowKey: string, options?: GetTableEntityOptions): Promise<GetTableEntityResponse<TableEntityResult<T>>>

المعلمات

partitionKey

string

مفتاح القسم للكيان.

rowKey

string

مفتاح الصف للكيان.

options
GetTableEntityOptions

معلمات الخيارات.

مثال على الحصول على كيان

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const entity = await client.getEntity("<partitionKey>", "<rowKey>");
console.log(`Entity: PartitionKey: ${entity.partitionKey} RowKey: ${entity.rowKey}`);

المرتجعات

Promise<GetTableEntityResponse<TableEntityResult<T>>>

listEntities<T>(ListTableEntitiesOptions)

الاستعلام عن الكيانات في جدول.

function listEntities<T>(options?: ListTableEntitiesOptions): PagedAsyncIterableIterator<TableEntityResult<T>, TableEntityResultPage<T>, PageSettings>

المعلمات

options
ListTableEntitiesOptions

معلمات الخيارات.

مثال على سرد الكيانات

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

let i = 0;
const entities = client.listEntities();
for await (const entity of entities) {
  console.log(`Entity${++i}: PartitionKey: ${entity.partitionKey} RowKey: ${entity.rowKey}`);
}

المرتجعات

PagedAsyncIterableIterator<TableEntityResult<T>, TableEntityResultPage<T>, PageSettings>

setAccessPolicy(SignedIdentifier[], OperationOptions)

تعيين نهج الوصول المخزنة للجدول الذي يمكن استخدامه مع توقيعات الوصول المشترك.

function setAccessPolicy(tableAcl: SignedIdentifier[], options?: OperationOptions): Promise<TableSetAccessPolicyHeaders>

المعلمات

tableAcl

SignedIdentifier[]

قائمة التحكم بالوصول للجدول.

options
OperationOptions

معلمات الخيارات.

المرتجعات

Promise<TableSetAccessPolicyHeaders>

submitTransaction(TransactionAction[], OperationOptions)

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

مثال على الاستخدام:

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient, TransactionAction } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const actions: TransactionAction[] = [
  ["create", { partitionKey: "p1", rowKey: "1", data: "test1" }],
  ["delete", { partitionKey: "p1", rowKey: "2" }],
  ["update", { partitionKey: "p1", rowKey: "3", data: "newTest" }, "Merge"],
];
const result = await client.submitTransaction(actions);

مثال على الاستخدام مع TableTransaction:

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient, TableTransaction } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const transaction = new TableTransaction();

// Call the available action in the TableTransaction object
transaction.createEntity({ partitionKey: "p1", rowKey: "1", data: "test1" });
transaction.deleteEntity("p1", "2");
transaction.updateEntity({ partitionKey: "p1", rowKey: "3", data: "newTest" }, "Merge");

// submitTransaction with the actions list on the transaction.
const result = await client.submitTransaction(transaction.actions);

function submitTransaction(actions: TransactionAction[], options?: OperationOptions): Promise<TableTransactionResponse>

المعلمات

actions

TransactionAction[]

المجموعة التي تحتوي على الإجراء المطلوب تنفيذه، والكيان الذي يجب تنفيذ الإجراء به

options
OperationOptions

خيارات الطلب.

المرتجعات

Promise<TableTransactionResponse>

updateEntity<T>(TableEntity<T>, UpdateMode, UpdateTableEntityOptions)

تحديث كيان في الجدول.

function updateEntity<T>(entity: TableEntity<T>, mode?: UpdateMode, options?: UpdateTableEntityOptions): Promise<TableUpdateEntityHeaders>

المعلمات

entity

TableEntity<T>

خصائص الكيان الذي سيتم تحديثه.

mode
UpdateMode

الأوضاع المختلفة لتحديث الكيان: - الدمج: تحديث كيان عن طريق تحديث خصائص الكيان دون استبدال الكيان الموجود. - استبدال: تحديث كيان موجود عن طريق استبدال الكيان بأكمله.

options
UpdateTableEntityOptions

معلمات الخيارات.

مثال على تحديث كيان

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const entity = { partitionKey: "p1", rowKey: "r1", bar: "updatedBar" };

// Update uses update mode "Merge" as default
// merge means that update will match a stored entity
// that has the same partitionKey and rowKey as the entity
// passed to the method and then will only update the properties present in it.
// Any other properties that are not defined in the entity passed to updateEntity
// will remain as they are in the service
await client.updateEntity(entity);

// We can also set the update mode to Replace, which will match the entity passed
// to updateEntity with one stored in the service and replace with the new one.
// If there are any missing properties in the entity passed to updateEntity, they
// will be removed from the entity stored in the service
await client.updateEntity(entity, "Replace");

المرتجعات

Promise<TableUpdateEntityHeaders>

upsertEntity<T>(TableEntity<T>, UpdateMode, OperationOptions)

رفع كيان في الجدول.

function upsertEntity<T>(entity: TableEntity<T>, mode?: UpdateMode, options?: OperationOptions): Promise<TableMergeEntityHeaders>

المعلمات

entity

TableEntity<T>

خصائص كيان الجدول.

mode
UpdateMode

الأوضاع المختلفة لتحديث الكيان: - الدمج: تحديث كيان عن طريق تحديث خصائص الكيان دون استبدال الكيان الموجود. - استبدال: تحديث كيان موجود عن طريق استبدال الكيان بأكمله.

options
OperationOptions

معلمات الخيارات.

مثال على رفع قيمة كيان

import { DefaultAzureCredential } from "@azure/identity";
import { TableClient } from "@azure/data-tables";

const account = "<account>";
const accountKey = "<accountkey>";
const tableName = "<tableName>";

const credential = new DefaultAzureCredential();
const client = new TableClient(`https://${account}.table.core.windows.net`, tableName, credential);

const entity = { partitionKey: "p1", rowKey: "r1", bar: "updatedBar" };

// Upsert uses update mode "Merge" as default.
// This behaves similarly to update but creates the entity
// if it doesn't exist in the service
await client.upsertEntity(entity);

// We can also set the update mode to Replace.
// This behaves similarly to update but creates the entity
// if it doesn't exist in the service
await client.upsertEntity(entity, "Replace");

المرتجعات

Promise<TableMergeEntityHeaders>