Aracılığıyla paylaş

TableClient class

Paket:
@azure/data-tables

TableClient, tek bir tabloda işlem gerçekleştirmenize olanak sağlayan Bir Azure Tabloları hizmeti İstemcisini temsil eder.

Oluşturucular

TableClient(string, string, NamedKeyCredential, TableServiceClientOptions)

TableClient sınıfının yeni bir örneğini oluşturur.
TableClient(string, string, SASCredential, TableServiceClientOptions)

TableClient sınıfının yeni bir örneğini oluşturur.
TableClient(string, string, TableServiceClientOptions)

TableClient örneği oluşturur.
TableClient(string, string, TokenCredential, TableServiceClientOptions)

TableClient sınıfının yeni bir örneğini oluşturur.

Özellikler

pipeline

URL'ye HTTP isteği göndermek için bir işlem hattını temsil eder. İşlem hatları, her isteğin sunucuya yapılmadan önce ve sonra manipülesini yönetmek için birden çok ilkeye sahip olabilir.
tableName

üzerinde işlem gerçekleştirilecek tablonun adı.
url

Tablo Hesabı URL'si

Yöntemler

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

Tabloya varlık ekleyin.
createTable(OperationOptions)

tableName değerinin istemci oluşturucusna iletildiğini içeren bir tablo oluşturur
deleteEntity(string, string, DeleteTableEntityOptions)

Tabloda belirtilen varlığı siler.
deleteTable(OperationOptions)

Geçerli tabloyu tüm varlıklarıyla birlikte kalıcı olarak siler.
fromConnectionString(string, string, TableServiceClientOptions)

Bağlantı dizesinden bir TableClient örneği oluşturur.
getAccessPolicy(OperationOptions)

Tabloda belirtilen ve Paylaşılan Erişim İmzaları ile kullanılabilecek tüm depolanmış erişim ilkeleriyle ilgili ayrıntıları alır.
getEntity<T>(string, string, GetTableEntityOptions)

Tabloda tek bir varlık döndürür.
listEntities<T>(ListTableEntitiesOptions)

Tablodaki varlıkları sorgular.
setAccessPolicy(SignedIdentifier[], OperationOptions)

Paylaşılan Erişim İmzaları ile kullanılabilecek tablo için depolanan erişim ilkelerini ayarlar.
submitTransaction(TransactionAction[], OperationOptions)

Bir eylem kümesinden oluşan bir İşlem gönderir. Eylemleri liste olarak sağlayabilir veya işlemi oluşturmaya yardımcı olmak için TableTransaction kullanabilirsiniz.

Örnek kullanım:

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 ile örnek kullanım:

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)

Tablodaki bir varlığı güncelleştirin.
upsertEntity<T>(TableEntity<T>, UpdateMode, OperationOptions)

Tabloya bir varlık ekleyin.

Oluşturucu Ayrıntıları

TableClient(string, string, NamedKeyCredential, TableServiceClientOptions)

TableClient sınıfının yeni bir örneğini oluşturur.

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

Parametreler

url

string

İstenen işlemin hedefi olan hizmet hesabının URL'si, örneğin "https://myaccount.table.core.windows.net".

tableName

string

tablonun adı

credential
NamedKeyCredential

İsteklerin kimliğini doğrulamak için kullanılan NamedKeyCredential. Yalnızca Düğüm için Desteklenir

options
TableServiceClientOptions

Opsiyonel. HTTP işlem hattını yapılandırma seçenekleri.

Hesap adı/anahtarı kullanan örnek:

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 sınıfının yeni bir örneğini oluşturur.

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

Parametreler

url

string

İstenen işlemin hedefi olan hizmet hesabının URL'si, örneğin "https://myaccount.table.core.windows.net".

tableName

string

tablonun adı

credential
SASCredential

İsteklerin kimliğini doğrulamak için kullanılan SASCredential

options
TableServiceClientOptions

Opsiyonel. HTTP işlem hattını yapılandırma seçenekleri.

SAS Belirteci kullanma örneği:

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 örneği oluşturur.

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

Parametreler

url

string

Azure Depolama tablo hizmetine işaret eden "https://myaccount.table.core.windows.net" gibi bir İstemci dizesi. "https://myaccount.table.core.windows.net?sasString" gibi bir SAS ekleyebilirsiniz.

tableName

string

tablonun adı

options
TableServiceClientOptions

HTTP işlem hattını yapılandırma seçenekleri.

SAS belirtecini ekleme örneği:

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 sınıfının yeni bir örneğini oluşturur.

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

Parametreler

url

string

İstenen işlemin hedefi olan hizmet hesabının URL'si, örneğin "https://myaccount.table.core.windows.net".

tableName

string

tablonun adı

credential
TokenCredential

İsteklerin kimliğini doğrulamak için kullanılan Azure Active Directory kimlik bilgileri

options
TableServiceClientOptions

Opsiyonel. HTTP işlem hattını yapılandırma seçenekleri.

Azure Active Directory kimlik bilgilerini kullanma örneği:

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,
);

Özellik Ayrıntıları

pipeline

URL'ye HTTP isteği göndermek için bir işlem hattını temsil eder. İşlem hatları, her isteğin sunucuya yapılmadan önce ve sonra manipülesini yönetmek için birden çok ilkeye sahip olabilir.

pipeline: Pipeline

Özellik Değeri

Pipeline

tableName

üzerinde işlem gerçekleştirilecek tablonun adı.

tableName: string

Özellik Değeri

string

url

Tablo Hesabı URL'si

url: string

Özellik Değeri

string

Yöntem Ayrıntıları

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

Tabloya varlık ekleyin.

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

Parametreler

entity

TableEntity<T>

Tablo varlığının özellikleri.

options
OperationOptions

Seçenekler parametreleri.

Varlık oluşturma örneği

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

Döndürülenler

Promise<TableInsertEntityHeaders>

createTable(OperationOptions)

tableName değerinin istemci oluşturucusna iletildiğini içeren bir tablo oluşturur

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

Parametreler

options
OperationOptions

Seçenekler parametreleri.

Tablo oluşturma örneği

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();

Döndürülenler

Promise<void>

deleteEntity(string, string, DeleteTableEntityOptions)

Tabloda belirtilen varlığı siler.

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

Parametreler

partitionKey

string

Varlığın bölüm anahtarı.

rowKey

string

Varlığın satır anahtarı.

options
DeleteTableEntityOptions

Seçenekler parametreleri.

Varlık silme örneği

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

Döndürülenler

Promise<TableDeleteEntityHeaders>

deleteTable(OperationOptions)

Geçerli tabloyu tüm varlıklarıyla birlikte kalıcı olarak siler.

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

Parametreler

options
OperationOptions

Seçenekler parametreleri.

Tablo silme örneği

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();

Döndürülenler

Promise<void>

fromConnectionString(string, string, TableServiceClientOptions)

Bağlantı dizesinden bir TableClient örneği oluşturur.

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

Parametreler

connectionString

string

Bir Azure depolama hesabının hesap bağlantı dizesi veya SAS bağlantı dizesi. [ Not - Hesap bağlantı dizesi yalnızca NODE.JS çalışma zamanında kullanılabilir. ] Hesap bağlantı dizesi örneği - SAS bağlantı dizesi örneği DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net - 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 işlem hattını yapılandırma seçenekleri.

Döndürülenler

TableClient

Verilen bağlantı dizesinden yeni bir TableClient.

getAccessPolicy(OperationOptions)

Tabloda belirtilen ve Paylaşılan Erişim İmzaları ile kullanılabilecek tüm depolanmış erişim ilkeleriyle ilgili ayrıntıları alır.

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

Parametreler

options
OperationOptions

Seçenekler parametreleri.

Döndürülenler

Promise<GetAccessPolicyResponse>

getEntity<T>(string, string, GetTableEntityOptions)

Tabloda tek bir varlık döndürür.

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

Parametreler

partitionKey

string

Varlığın bölüm anahtarı.

rowKey

string

Varlığın satır anahtarı.

options
GetTableEntityOptions

Seçenekler parametreleri.

Varlık alma örneği

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

Döndürülenler

Promise<GetTableEntityResponse<TableEntityResult<T>>>

listEntities<T>(ListTableEntitiesOptions)

Tablodaki varlıkları sorgular.

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

Parametreler

options
ListTableEntitiesOptions

Seçenekler parametreleri.

Varlıkların listelendiği örnek

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

Döndürülenler

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

setAccessPolicy(SignedIdentifier[], OperationOptions)

Paylaşılan Erişim İmzaları ile kullanılabilecek tablo için depolanan erişim ilkelerini ayarlar.

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

Parametreler

tableAcl

SignedIdentifier[]

Tablonun Erişim Denetim Listesi.

options
OperationOptions

Seçenekler parametreleri.

Döndürülenler

Promise<TableSetAccessPolicyHeaders>

submitTransaction(TransactionAction[], OperationOptions)

Bir eylem kümesinden oluşan bir İşlem gönderir. Eylemleri liste olarak sağlayabilir veya işlemi oluşturmaya yardımcı olmak için TableTransaction kullanabilirsiniz.

Örnek kullanım:

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 ile örnek kullanım:

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>

Parametreler

actions

TransactionAction[]

gerçekleştirilecek eylemi içeren tanımlama grubu ve eylemin gerçekleştirleneceği varlık

options
OperationOptions

İstek için seçenekler.

Döndürülenler

Promise<TableTransactionResponse>

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

Tablodaki bir varlığı güncelleştirin.

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

Parametreler

entity

TableEntity<T>

Güncelleştirilecek varlığın özellikleri.

mode
UpdateMode

Varlığı güncelleştirmek için farklı modlar: - Birleştirme: Varlığın özelliklerini mevcut varlığı değiştirmeden güncelleştirerek varlığı güncelleştirir. - Değiştir: Varlığın tamamını değiştirerek var olan bir varlığı güncelleştirir.

options
UpdateTableEntityOptions

Seçenekler parametreleri.

Varlığı güncelleştirme örneği

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

Döndürülenler

Promise<TableUpdateEntityHeaders>

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

Tabloya bir varlık ekleyin.

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

Parametreler

entity

TableEntity<T>

Tablo varlığının özellikleri.

mode
UpdateMode

Varlığı güncelleştirmek için farklı modlar: - Birleştirme: Varlığın özelliklerini mevcut varlığı değiştirmeden güncelleştirerek varlığı güncelleştirir. - Değiştir: Varlığın tamamını değiştirerek var olan bir varlığı güncelleştirir.

options
OperationOptions

Seçenekler parametreleri.

Bir varlığın upserting örneği

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

Döndürülenler

Promise<TableMergeEntityHeaders>