TableServiceClient Sınıf

Başvuru

Tablo Hizmeti ile hesap düzeyinde etkileşim kuran bir istemci.

Bu istemci hesap özelliklerini alıp yapılandırmanın yanı sıra hesap içindeki tabloları listeleme, oluşturma ve silme işlemlerini sağlar. Belirli bir tabloyla ilgili işlemler için, bu varlık için bir istemci işlevi kullanılarak get_table_client alınabilir.

Bir Kimlik Bilgisi'nden TablesBaseClient oluşturun.

Devralma: azure.data.tables._base_client.TablesBaseClient

TableServiceClient

Oluşturucu

TableServiceClient(endpoint: str, *, credential: AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs)

Parametreler

endpoint: str

Gerekli

Tablo hizmeti uç noktasının URL'si. URL yoluna dahil edilen diğer varlıklar (örn. tablo) atılır. Bu URL isteğe bağlı olarak bir SAS belirteci ile doğrulanabilir.

credential: AzureNamedKeyCredential veya AzureSasCredential veya TokenCredential veya None

Kimlik doğrulaması için kullanılan kimlik bilgileri. Hesap URL'sinde zaten bir SAS belirteci varsa bu isteğe bağlıdır. Değer AzureNamedKeyCredential (azure-core), AzureSasCredential (azure-core) veya azure-identity'den tokenCredential uygulamasından biri olabilir.

api_version: str

İstekler için kullanılacak Depolama API'sinin sürümü. Varsayılan değer: '2019-02-02'. Eski bir sürüme ayar yapmak özellik uyumluluğunu azaltabilir.

endpoint: str

Gerekli

Azure Tabloları hesabının URL'si.

credential: AzureNamedKeyCredential veya AzureSasCredential veya TokenCredential veya None

api_version: str veya None

Bu istek için kullanılacak işlemin sürümünü belirtir. Varsayılan değer "2019-02-02"dir.

Örnekler

Paylaşılan Erişim Anahtarından TableServiceClient Kimliğini Doğrulama


   from azure.data.tables import TableServiceClient
   from azure.core.credentials import AzureNamedKeyCredential, AzureSasCredential

   # Create a SAS token to use for authentication of a client
   from azure.data.tables import generate_account_sas, ResourceTypes, AccountSasPermissions

   print("Account name: {}".format(self.account_name))
   credential = AzureNamedKeyCredential(self.account_name, self.access_key)  # type: ignore[arg-type]
   sas_token = generate_account_sas(
       credential,
       resource_types=ResourceTypes(service=True),
       permission=AccountSasPermissions(read=True),
       expiry=datetime.utcnow() + timedelta(hours=1),
   )

   with TableServiceClient(
       endpoint=self.endpoint, credential=AzureSasCredential(sas_token)
   ) as token_auth_table_service:
       properties = token_auth_table_service.get_service_properties()
       print("Shared Access Signature: {}".format(properties))

Paylaşılan Hesap Anahtarından TableServiceClient Kimliğini Doğrulama


   from azure.data.tables import TableServiceClient
   from azure.core.credentials import AzureNamedKeyCredential

   credential = AzureNamedKeyCredential(self.account_name, self.access_key)  # type: ignore[arg-type]
   with TableServiceClient(endpoint=self.endpoint, credential=credential) as table_service:
       properties = table_service.get_service_properties()
       print("Shared Key: {}".format(properties))

Değişkenler

account_name: str

Tablolar hesabının adı.

url: str

Tablolar hesabının tam URL'si.

Yöntemler

close	Bu yöntem, istemci tarafından açılan yuvaları kapatmaktır. Bağlam yöneticisi ile kullanılırken kullanılması gerekmez.
create_table	Geçerli hesabın altında yeni bir tablo oluşturur.
create_table_if_not_exists	Şu anda yoksa yeni bir tablo oluşturur. Tablo şu anda varsa, geçerli tablo döndürülür.
delete_table	Geçerli hesabın altındaki tabloyu siler. Verilen tablo bulunamazsa hata oluşmaz.
from_connection_string	Bağlantı dizesinden TableServiceClient oluşturun.
get_service_properties	Analiz ve CORS (Çıkış Noktaları Arası Kaynak Paylaşımı) kurallarının özellikleri de dahil olmak üzere bir hesabın Tablo hizmetinin özelliklerini alır.
get_service_stats	Tablo hizmeti için çoğaltmayla ilgili istatistikleri alır. Yalnızca hesap için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde ikincil konum uç noktasında kullanılabilir.
get_table_client	Belirtilen tabloyla etkileşime geçmek için bir istemci alın. Tablo zaten mevcut değil.
list_tables	Verilen hesabın altındaki tabloları sorgular.
query_tables	Verilen hesabın altındaki tabloları sorgular.
set_service_properties	Analiz ve CORS (Çıkış Noktaları Arası Kaynak Paylaşımı) kurallarının özellikleri de dahil olmak üzere bir hesabın Tablo hizmet uç noktasının özelliklerini ayarlar.

close

Bu yöntem, istemci tarafından açılan yuvaları kapatmaktır. Bağlam yöneticisi ile kullanılırken kullanılması gerekmez.

close() -> None

create_table

Geçerli hesabın altında yeni bir tablo oluşturur.

create_table(table_name: str, **kwargs) -> TableClient

Parametreler

table_name: str

Gerekli

Tablo adı.

Döndürülenler

TableClient

Dönüş türü

TableClient

Özel durumlar

ResourceExistsError

Örnekler

TableServiceClient nesnesinden tablo oluşturma


   with TableServiceClient.from_connection_string(self.connection_string) as table_service_client:
       try:
           table_client = table_service_client.create_table(table_name=self.table_name)
           print("Created table {}!".format(table_client.table_name))
       except ResourceExistsError:
           print("Table already exists")

create_table_if_not_exists

Şu anda yoksa yeni bir tablo oluşturur. Tablo şu anda varsa, geçerli tablo döndürülür.

create_table_if_not_exists(table_name: str, **kwargs) -> TableClient

Parametreler

table_name: str

Gerekli

Tablo adı.

Döndürülenler

TableClient

Dönüş türü

TableClient

Özel durumlar

HttpResponseError

Örnekler

Tablo yoksa TableServiceClient nesnesinden tablo oluşturma


   with TableServiceClient.from_connection_string(self.connection_string) as table_service_client:
       table_client = table_service_client.create_table_if_not_exists(table_name=self.table_name)
       print("Table name: {}".format(table_client.table_name))

delete_table

Geçerli hesabın altındaki tabloyu siler. Verilen tablo bulunamazsa hata oluşmaz.

delete_table(table_name: str, **kwargs) -> None

Parametreler

table_name: str

Gerekli

Tablo adı.

Döndürülenler

Hiçbiri

Özel durumlar

HttpResponseError

Örnekler

TableServiceClient nesnesinden tablo silme


   with TableServiceClient.from_connection_string(self.connection_string) as table_service_client:
       table_service_client.delete_table(table_name=self.table_name)
       print("Deleted table {}!".format(self.table_name))

from_connection_string

Bağlantı dizesinden TableServiceClient oluşturun.

from_connection_string(conn_str: str, **kwargs) -> TableServiceClient

Parametreler

conn_str: str

Gerekli

Azure Depolama veya Cosmos hesabına bağlantı dizesi.

Döndürülenler

Tablo hizmeti istemcisi.

Dönüş türü

TableServiceClient

Örnekler

bir connection_string TableServiceClient kimliğini doğrulama


   from azure.data.tables import TableServiceClient

   with TableServiceClient.from_connection_string(conn_str=self.connection_string) as table_service:
       properties = table_service.get_service_properties()
       print("Connection String: {}".format(properties))

get_service_properties

Analiz ve CORS (Çıkış Noktaları Arası Kaynak Paylaşımı) kurallarının özellikleri de dahil olmak üzere bir hesabın Tablo hizmetinin özelliklerini alır.

get_service_properties(**kwargs) -> Dict[str, object]

Döndürülenler

Hizmet özellikleri sözlüğü

Dönüş türü

dict[str, object]

Özel durumlar

HttpResponseError

get_service_stats

Tablo hizmeti için çoğaltmayla ilgili istatistikleri alır. Yalnızca hesap için okuma erişimli coğrafi olarak yedekli çoğaltma etkinleştirildiğinde ikincil konum uç noktasında kullanılabilir.

get_service_stats(**kwargs) -> Dict[str, object]

Döndürülenler

Hizmet istatistikleri sözlüğü

Dönüş türü

dict[str, object]

Özel durumlar

azure.core.exceptions.HttpResponseError:

get_table_client

Belirtilen tabloyla etkileşime geçmek için bir istemci alın.

Tablo zaten mevcut değil.

get_table_client(table_name: str, **kwargs) -> TableClient

Parametreler

table_name: str

Gerekli

Tablo adı

Döndürülenler

Bir TableClient nesnesi.

Dönüş türü

TableClient

list_tables

Verilen hesabın altındaki tabloları sorgular.

list_tables(**kwargs) -> ItemPaged[TableItem]

Parametreler

results_per_page: int

Döndürülen ItemPaged içindeki sayfa başına tablo sayısı

Döndürülenler

Yineleyici TableItem

Dönüş türü

ItemPaged[TableItem]

Özel durumlar

HttpResponseError

Örnekler

Depolama hesabındaki tüm tabloları listeleme


   # List all the tables in the service
   list_tables = table_service.list_tables()
   print("Listing tables:")
   for table in list_tables:
       print("\t{}".format(table.name))

query_tables

Verilen hesabın altındaki tabloları sorgular.

query_tables(query_filter: str, **kwargs) -> ItemPaged[TableItem]

Parametreler

query_filter: str

Gerekli

Belirli tabloları döndürmek için bir filtre belirtin.

results_per_page: int

Döndürülen ItemPaged içindeki sayfa başına tablo sayısı

parameters: dict[str, Any]

Sorguyu ek, kullanıcı tanımlı parametrelerle biçimlendirmek için sözlük

Döndürülenler

Yineleyici TableItem

Dönüş türü

ItemPaged[TableItem]

Özel durumlar

HttpResponseError

Örnekler

Depolama hesabındaki tabloları sorgulama


   table_name = "mytable1"
   name_filter = "TableName eq '{}'".format(table_name)
   queried_tables = table_service.query_tables(name_filter)

   print("Queried_tables")
   for table in queried_tables:
       print("\t{}".format(table.name))

set_service_properties

Analiz ve CORS (Çıkış Noktaları Arası Kaynak Paylaşımı) kurallarının özellikleri de dahil olmak üzere bir hesabın Tablo hizmet uç noktasının özelliklerini ayarlar.

set_service_properties(**kwargs) -> None

Parametreler

analytics_logging: TableAnalyticsLogging

Analiz özellikleri

hour_metrics: TableMetrics

Saat düzeyi ölçümleri

minute_metrics: TableMetrics

Dakika düzeyi ölçümleri

cors: list[TableCorsRule]

Çıkış noktaları arası kaynak paylaşım kuralları

Döndürülenler

Hiçbiri

Özel durumlar

HttpResponseError

Öznitelikler

api_version

İstekler için kullanılan Depolama API'sinin sürümü.

Döndürülenler

Depolama API'sinin sürümü.

url

Kullanılırsa SAS belirteci de dahil olmak üzere bu varlığın tam uç nokta URL'si.

Bu, geçerli <xref:azure.data.tables.location_mode>öğesine bağlı olarak birincil uç nokta veya ikincil uç nokta olabilir.

Döndürülenler

Kullanılıyorsa SAS belirteci de dahil olmak üzere tam uç nokta URL'si.

Dönüş türü

str

TableServiceClient Sınıf

Oluşturucu

Parametreler

Örnekler

Değişkenler

Yöntemler

close

create_table

Parametreler

Döndürülenler

Dönüş türü

Özel durumlar

Örnekler

create_table_if_not_exists

Parametreler

Döndürülenler

Dönüş türü

Özel durumlar

Örnekler

delete_table

Parametreler

Döndürülenler

Özel durumlar

Örnekler

from_connection_string

Parametreler

Döndürülenler

Dönüş türü

Örnekler

get_service_properties

Döndürülenler

Dönüş türü

Özel durumlar

get_service_stats

Döndürülenler

Dönüş türü

Özel durumlar

get_table_client

Parametreler

Döndürülenler

Dönüş türü

list_tables

Parametreler

Döndürülenler

Dönüş türü

Özel durumlar

Örnekler

query_tables

Parametreler

Döndürülenler

Dönüş türü

Özel durumlar

Örnekler

set_service_properties

Parametreler

Döndürülenler

Özel durumlar

Öznitelikler

api_version

Döndürülenler

url

Döndürülenler

Dönüş türü

Geri Bildirim

Ek kaynaklar