TableService Klass

Det här är huvudklassen som hanterar Azure Table-resurser.

Azure Table-tjänsten erbjuder strukturerad lagring i form av tabeller. Tabeller lagrar data som samlingar av entiteter. Entiteter liknar rader. En entitet har en primärnyckel och en uppsättning egenskaper. En egenskap är ett namn, typat värdepar, som liknar en kolumn. Tabelltjänsten tillämpar inte något schema för tabeller, så två entiteter i samma tabell kan ha olika uppsättningar egenskaper. Utvecklare kan välja att framtvinga ett schema på klientsidan. En tabell kan innehålla valfritt antal entiteter.

Arv

StorageClient

TableService

Konstruktor

TableService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', request_session=None, connection_string=None, socket_timeout=None)

Parametrar

Name	Description
account_name	str Namnet på lagringskontot. Detta används för att autentisera begäranden som signerats med en kontonyckel och för att konstruera lagringsslutpunkten. Det krävs om inte en anslutningssträng anges. standardvärde: None
account_key	str Nyckeln till lagringskontot. Detta används för autentisering med delad nyckel. standardvärde: None
sas_token	str En signaturtoken för delad åtkomst som ska användas för att autentisera begäranden i stället för kontonyckeln. Om både kontonyckel och sas-token anges används kontonyckeln för att signera. standardvärde: None
is_emulated	bool Om emulatorn ska användas. Standardvärdet är Falskt. Om detta anges åsidosätter du alla andra parametrar förutom anslutningssträngen och begärandesessionen. standardvärde: False
protocol	str Det protokoll som ska användas för begäranden. Standardvärdet är https. standardvärde: https
endpoint_suffix	str Värdbaskomponenten för URL:en, minus kontonamnet. Standardinställningar för Azure (core.windows.net). Åsidosätt detta för att använda Kina-molnet (core.chinacloudapi.cn). standardvärde: core.windows.net
request_session	<xref:requests.Session> Sessionsobjektet som ska användas för http-begäranden. standardvärde: None
connection_string	str Om detta anges åsidosätter detta alla andra parametrar förutom begärandesessionen. Se http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ format för anslutningssträngen. standardvärde: None
socket_timeout	int Om detta anges åsidosätter detta standardtimeouten för socket. Den angivna tidsgränsen är i sekunder. Se DEFAULT_SOCKET_TIMEOUT i _constants.py för standardvärdet. standardvärde: None

Variabler

Name	Description
key_encryption_key	object Nyckelkrypteringsnyckeln som eventuellt tillhandahålls av användaren. Om detta anges används för att kryptera/dekryptera i metoder som stöds. För metoder som kräver dekryptering måste antingen key_encryption_key ELLER matcharen anges. Om båda anges har matcharen företräde. Måste implementera följande metoder för API:er som kräver kryptering: wrap_key(nyckel)–omsluter den angivna nyckeln (byte) med hjälp av en algoritm som användaren väljer. Returnerar den krypterade nyckeln som byte. get_key_wrap_algorithm()– returnerar algoritmen som används för att omsluta den angivna symmetriska nyckeln. get_kid()– returnerar ett strängnyckel-ID för den här nyckelkrypteringsnyckeln. Måste implementera följande metoder för API:er som kräver dekryptering: unwrap_key(nyckel, algoritm)– returnerar den owrappade formen av den angivna symmetriska nyckeln med hjälp av den strängdefinierade algoritmen. get_kid()– returnerar ett strängnyckel-ID för den här nyckelkrypteringsnyckeln.
key_resolver_function	kid) (<xref:function> En funktion för att matcha nycklar som tillhandahålls av användaren. Om detta anges kommer att användas för att dekryptera i metoder som stöds. För metoder som kräver dekryptering måste antingen key_encryption_key ELLER matcharen anges. Om båda anges har matcharen företräde. Den använder barnsträngen för att returnera en nyckelkrypteringsnyckel som implementerar gränssnittet som definierats ovan.
encryption_resolver_functions	<xref:function>(<xref:partition_key>, <xref:row_key>, <xref:property_name>) En funktion som tar in en entitets partitionsnyckel, radnyckel och egenskapsnamn och returnerar ett booleskt värde som anger om den egenskapen ska krypteras.
require_encryption	bool En flagga som kan ställas in för att säkerställa att alla meddelanden har laddats upp till kön och att alla som laddats ned och lästs från kön har krypterats på servern. Om den här flaggan anges måste alla obligatoriska parametrar för kryptering/dekryptering anges. Se kommentarerna ovan på key_encryption_key och resolver.

Metoder

batch	Skapar ett batchobjekt som kan användas som kontexthanterare. Genomför batchen vid avslut.
commit_batch	Genomför en <xref:azure.storage.table.TableBatch> begäran.
create_table	Skapar en ny tabell i lagringskontot.
delete_entity	Tar bort en befintlig entitet i en tabell. Utlöser om entiteten inte finns. När en entitet har tagits bort markeras entiteten omedelbart för borttagning och är inte längre tillgänglig för klienter. Entiteten tas senare bort från tabelltjänsten under skräpinsamlingen.
delete_table	Tar bort den angivna tabellen och alla data som den innehåller. När en tabell har tagits bort markeras den omedelbart för borttagning och är inte längre tillgänglig för klienter. Tabellen tas senare bort från tabelltjänsten under skräpinsamlingen. Observera att det sannolikt tar minst 40 sekunder att ta bort en tabell. Om en åtgärd görs mot tabellen när den togs bort utlöses en <xref:azure.cosmosdb.table.tableservice.AzureConflictHttpError> .
exists	Returnerar ett booleskt värde som anger om tabellen finns.
extract_date_and_request_id
generate_account_shared_access_signature	Genererar en signatur för delad åtkomst för tabelltjänsten. Använd den returnerade signaturen med parametern sas_token för TableService.
generate_table_shared_access_signature	Genererar en signatur för delad åtkomst för tabellen. Använd den returnerade signaturen med parametern sas_token för TableService.
get_entity	Hämta en entitet från den angivna tabellen. Utlöser om entiteten inte finns.
get_table_acl	Returnerar information om lagrade åtkomstprinciper som anges i tabellen som kan användas med signaturer för delad åtkomst.
get_table_service_properties	Hämtar egenskaperna för ett lagringskontos Tabelltjänst, inklusive loggning, analys och CORS-regler.
get_table_service_stats	Hämtar statistik som rör replikering för tabelltjänsten. Den är endast tillgänglig när geo-redundant replikering med läsåtkomst är aktiverad för lagringskontot. Med geo-redundant replikering underhåller Azure Storage dina data på två platser. På båda platserna underhåller Azure Storage ständigt flera felfria repliker av dina data. Platsen där du läser, skapar, uppdaterar eller tar bort data är den primära lagringskontoplatsen. Den primära platsen finns i den region som du väljer när du skapar ett konto via den klassiska Azure-portalen för Azure Management, till exempel USA, norra centrala. Den plats som dina data replikeras till är den sekundära platsen. Den sekundära platsen bestäms automatiskt baserat på platsen för den primära platsen. det är i ett andra datacenter som finns i samma region som den primära platsen. Skrivskyddad åtkomst är tillgänglig från den sekundära platsen, om geo-redundant replikering med läsbehörighet är aktiverad för ditt lagringskonto.
insert_entity	Infogar en ny entitet i tabellen. Genererar om en entitet med samma PartitionKey och RowKey redan finns. När du infogar en entitet i en tabell måste du ange värden för systemegenskaperna PartitionKey och RowKey. Tillsammans utgör dessa egenskaper primärnyckeln och måste vara unika i tabellen. Både Värdena PartitionKey och RowKey måste vara strängvärden. varje nyckelvärde kan vara upp till 64 kB stort. Om du använder ett heltalsvärde för nyckelvärdet bör du konvertera heltalet till en sträng med fast bredd eftersom de är kanoniskt sorterade. Du bör till exempel konvertera värdet 1 till 0000001 för att säkerställa korrekt sortering.
insert_or_merge_entity	Sammanfogar en befintlig entitet eller infogar en ny entitet om den inte finns i tabellen. Om insert_or_merge_entity används för att sammanfoga en entitet behålls alla egenskaper från den tidigare entiteten om begäran inte definierar eller inkluderar dem.
insert_or_replace_entity	Ersätter en befintlig entitet eller infogar en ny entitet om den inte finns i tabellen. Eftersom den här åtgärden kan infoga eller uppdatera en entitet kallas den även för en "upsert"-åtgärd. Om insert_or_replace_entity används för att ersätta en entitet tas alla egenskaper från den tidigare entiteten bort om den nya entiteten inte definierar dem.
list_tables	Returnerar en generator för att visa tabellerna. Generatorn följer lätt fortsättningstoken som returneras av tjänsten och stoppas när alla tabeller har returnerats eller num_results har nåtts. Om num_results anges och kontot har fler än det antalet tabeller har generatorn ett ifyllt next_marker fält när det har slutförts. Den här markören kan användas för att skapa en ny generator om fler resultat önskas.
merge_entity	Uppdateringar en befintlig entitet genom att slå samman entitetens egenskaper. Utlöser om entiteten inte finns. Den här åtgärden ersätter inte den befintliga entiteten som den update_entity åtgärden gör. Det går inte att ta bort en egenskap med merge_entity. Alla egenskaper med null-värden ignoreras. Alla andra egenskaper uppdateras eller läggs till.
query_entities	Returnerar en generator för att visa entiteterna i den angivna tabellen. Generatorn följer lätt de fortsättningstoken som returneras av tjänsten och stoppas när alla entiteter har returnerats eller num_results har nåtts. Om num_results anges och kontot har fler än det antalet entiteter har generatorn ett ifyllt next_marker fält när det har slutförts. Den här markören kan användas för att skapa en ny generator om fler resultat önskas.
set_proxy	Anger proxyserverns värd och port för HTTP CONNECT-tunnlar.
set_table_acl	Anger lagrade åtkomstprinciper för tabellen som kan användas med signaturer för delad åtkomst. När du anger behörigheter för en tabell ersätts de befintliga behörigheterna. Om du vill uppdatera tabellens behörigheter anropar get_table_acl du för att hämta alla åtkomstprinciper som är associerade med tabellen, ändrar åtkomstprincipen som du vill ändra och anropar sedan den här funktionen med den fullständiga datauppsättningen för att utföra uppdateringen. När du upprättar en lagrad åtkomstprincip i en tabell kan det ta upp till 30 sekunder att börja gälla. Under det här intervallet genererar en signatur för delad åtkomst som är associerad med den lagrade åtkomstprincipen en <xref:azure.cosmosdb.table.tableservice.AzureHttpError> tills åtkomstprincipen blir aktiv.
set_table_service_properties	Anger egenskaperna för ett lagringskontos tabelltjänst, inklusive Azure Lagringsanalys. Om ett element (t.ex. loggning) lämnas som Ingen bevaras de befintliga inställningarna för tjänsten för den funktionen. Mer information om Azure Lagringsanalys finns i https://msdn.microsoft.com/en-us/library/azure/hh343270.aspx.
update_entity	Uppdateringar en befintlig entitet i en tabell. Utlöser om entiteten inte finns. Åtgärden update_entity ersätter hela entiteten och kan användas för att ta bort egenskaper.

batch

Skapar ett batchobjekt som kan användas som kontexthanterare. Genomför batchen vid avslut.

batch(table_name, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som batchen ska checkas in på.
timeout Obligatorisk	int Serverns timeout uttryckt i sekunder.

commit_batch

Genomför en <xref:azure.storage.table.TableBatch> begäran.

commit_batch(table_name, batch, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som batchen ska checkas in på.
batch Obligatorisk	TableBatch Batchen som ska checkas in.
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
list(AzureBatchOperationError, str)	En lista över batchsvaren som motsvarar begärandena i batchen. Objekten kan antingen vara en etag, om det lyckas, eller ett felobjekt i händelse av fel.

create_table

Skapar en ny tabell i lagringskontot.

create_table(table_name, fail_on_exist=False, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på den tabell som ska skapas. Tabellnamnet får bara innehålla alfanumeriska tecken och kan inte börja med ett numeriskt tecken. Den är skiftlägesokänslig och måste vara mellan 3 och 63 tecken lång.
fail_on_exist	bool Anger om ett undantag ska utlösas om tabellen redan finns. standardvärde: False
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
bool	Ett booleskt värde som anger om tabellen har skapats. Om fail_on_exist har angetts till Sant utlöser detta i stället för att returnera falskt.

delete_entity

Tar bort en befintlig entitet i en tabell. Utlöser om entiteten inte finns.

När en entitet har tagits bort markeras entiteten omedelbart för borttagning och är inte längre tillgänglig för klienter. Entiteten tas senare bort från tabelltjänsten under skräpinsamlingen.

delete_entity(table_name, partition_key, row_key, if_match='*', timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som innehåller entiteten som ska tas bort.
partition_key Obligatorisk	str PartitionKey för entiteten.
row_key Obligatorisk	str RowKey för entiteten.
if_match	str Klienten kan ange ETag för entiteten på begäran för att jämföra med den ETag som underhålls av tjänsten för optimistisk samtidighet. Borttagningsåtgärden utförs endast om ETag som skickas av klienten matchar värdet som upprätthålls av servern, vilket indikerar att entiteten inte har ändrats sedan den hämtades av klienten. Om du vill tvinga fram en ovillkorlig borttagning anger du If-Match till jokertecknet (*). standardvärde: *
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

delete_table

Tar bort den angivna tabellen och alla data som den innehåller.

När en tabell har tagits bort markeras den omedelbart för borttagning och är inte längre tillgänglig för klienter. Tabellen tas senare bort från tabelltjänsten under skräpinsamlingen.

Observera att det sannolikt tar minst 40 sekunder att ta bort en tabell. Om en åtgärd görs mot tabellen när den togs bort utlöses en <xref:azure.cosmosdb.table.tableservice.AzureConflictHttpError> .

delete_table(table_name, fail_not_exist=False, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som ska tas bort.
fail_not_exist	bool Anger om ett undantag ska utlösas om tabellen inte finns. standardvärde: False
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
bool	Ett booleskt värde som anger om tabellen har tagits bort. Om fail_not_exist har angetts till Sant utlöser detta i stället för att returnera falskt.

exists

Returnerar ett booleskt värde som anger om tabellen finns.

exists(table_name, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som ska kontrolleras om den finns.
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
bool	Ett booleskt värde som anger om tabellen finns.

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parametrar

Name	Description
retry_context Obligatorisk

generate_account_shared_access_signature

Genererar en signatur för delad åtkomst för tabelltjänsten. Använd den returnerade signaturen med parametern sas_token för TableService.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

Parametrar

Name	Description
resource_types Obligatorisk	ResourceTypes Anger de resurstyper som är tillgängliga med kontots SAS.
permission Obligatorisk	AccountPermissions De behörigheter som är associerade med signaturen för delad åtkomst. Användaren är begränsad till åtgärder som tillåts av behörigheterna. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip.
expiry Obligatorisk	datetime eller str Den tidpunkt då signaturen för delad åtkomst blir ogiltig. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip. Azure konverterar alltid värden till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC.
start	datetime eller str Den tidpunkt då signaturen för delad åtkomst blir giltig. Om det utelämnas antas starttiden för det här anropet vara den tid då lagringstjänsten tar emot begäran. Azure konverterar alltid värden till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. standardvärde: None
ip	str Anger en IP-adress eller ett intervall med IP-adresser som begäranden ska accepteras från. Om DEN IP-adress som begäran kommer från inte matchar IP-adressen eller adressintervallet som anges på SAS-token autentiseras inte begäran. Om du till exempel anger sip=168.1.5.65 eller sip=168.1.5.60-168.1.5.70 på SAS begränsas begäran till dessa IP-adresser. standardvärde: None
protocol	str Anger vilket protokoll som tillåts för en begäran. Standardvärdet är https,http. Se Protocol för möjliga värden. standardvärde: None

Returer

Typ	Description
str	En sas-token (signatur för delad åtkomst).

generate_table_shared_access_signature

Genererar en signatur för delad åtkomst för tabellen. Använd den returnerade signaturen med parametern sas_token för TableService.

generate_table_shared_access_signature(table_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, start_pk=None, start_rk=None, end_pk=None, end_rk=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som du vill skapa en SAS-token för.
permission	TablePermissions De behörigheter som är associerade med signaturen för delad åtkomst. Användaren är begränsad till åtgärder som tillåts av behörigheterna. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip. standardvärde: None
expiry	datetime eller str Den tidpunkt då signaturen för delad åtkomst blir ogiltig. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip. Azure konverterar alltid värden till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. standardvärde: None
start	datetime eller str Den tidpunkt då signaturen för delad åtkomst blir giltig. Om det utelämnas antas starttiden för det här anropet vara den tid då lagringstjänsten tar emot begäran. Azure konverterar alltid värden till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. standardvärde: None
id	str Ett unikt värde på upp till 64 tecken som korrelerar med en lagrad åtkomstprincip. Om du vill skapa en lagrad åtkomstprincip använder du set_table_acl. standardvärde: None
ip	str Anger en IP-adress eller ett intervall med IP-adresser som begäranden ska accepteras från. Om DEN IP-adress som begäran kommer från inte matchar IP-adressen eller adressintervallet som anges på SAS-token autentiseras inte begäran. Om du till exempel anger sip='168.1.5.65' eller sip='168.1.5.60-168.1.5.70' på SAS begränsas begäran till dessa IP-adresser. standardvärde: None
protocol	str Anger vilket protokoll som tillåts för en begäran. Standardvärdet är https,http. Se Protocol för möjliga värden. standardvärde: None
start_pk	str Minsta partitionsnyckel som är tillgänglig med signaturen för delad åtkomst. startpk måste följa med startrk. Nyckelvärden är inkluderande. Om det utelämnas finns det ingen lägre gräns för de tabellentiteter som kan nås. standardvärde: None
start_rk	str Minsta radnyckel som är tillgänglig med signaturen för delad åtkomst. startpk måste följa med startrk. Nyckelvärden är inkluderande. Om det utelämnas finns det ingen lägre gräns för de tabellentiteter som kan nås. standardvärde: None
end_pk	str Den maximala partitionsnyckeln som är tillgänglig med den här signaturen för delad åtkomst. endpk måste följa med endrk. Nyckelvärden är inkluderande. Om det utelämnas finns det ingen övre gräns för de tabellentiteter som kan nås. standardvärde: None
end_rk	str Den maximala radnyckeln som är tillgänglig med signaturen för delad åtkomst. endpk måste följa med endrk. Nyckelvärden är inkluderande. Om det utelämnas finns det ingen övre gräns för de tabellentiteter som kan nås. standardvärde: None

Returer

Typ	Description
str	En sas-token (signatur för delad åtkomst).

get_entity

Hämta en entitet från den angivna tabellen. Utlöser om entiteten inte finns.

get_entity(table_name, partition_key, row_key, select=None, accept='application/json;odata=minimalmetadata', property_resolver=None, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som entiteten ska hämtas från.
partition_key Obligatorisk	str PartitionKey för entiteten.
row_key Obligatorisk	str RowKey för entiteten.
select	str Returnerar endast önskade egenskaper för en entitet från uppsättningen. standardvärde: None
accept	str Anger den godkända innehållstypen för svarsnyttolasten. Se <xref:azure.storage.table.models.TablePayloadFormat> för möjliga värden. standardvärde: application/json;odata=minimalmetadata
property_resolver	<xref:func>(<xref:pk>, <xref:rk>, <xref:prop_name>, <xref:prop_value>, <xref:service_edm_type>) En funktion som ger partitionsnyckeln, radnyckeln, egenskapsnamnet, egenskapsvärdet och egenskapen EdmType om den returneras av tjänsten, returnerar egenskapens EdmType. Används vanligtvis om accept är inställt på JSON_NO_METADATA. standardvärde: None
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
Entity	Den hämtade entiteten.

get_table_acl

Returnerar information om lagrade åtkomstprinciper som anges i tabellen som kan användas med signaturer för delad åtkomst.

get_table_acl(table_name, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på en befintlig tabell.
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
dict(str, AccessPolicy)	En ordlista med åtkomstprinciper som är associerade med tabellen.

get_table_service_properties

Hämtar egenskaperna för ett lagringskontos Tabelltjänst, inklusive loggning, analys och CORS-regler.

get_table_service_properties(timeout=None)

Parametrar

Name	Description
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
ServiceProperties	Egenskaperna för tabelltjänsten.

get_table_service_stats

Hämtar statistik som rör replikering för tabelltjänsten. Den är endast tillgänglig när geo-redundant replikering med läsåtkomst är aktiverad för lagringskontot.

Med geo-redundant replikering underhåller Azure Storage dina data på två platser. På båda platserna underhåller Azure Storage ständigt flera felfria repliker av dina data. Platsen där du läser, skapar, uppdaterar eller tar bort data är den primära lagringskontoplatsen. Den primära platsen finns i den region som du väljer när du skapar ett konto via den klassiska Azure-portalen för Azure Management, till exempel USA, norra centrala. Den plats som dina data replikeras till är den sekundära platsen. Den sekundära platsen bestäms automatiskt baserat på platsen för den primära platsen. det är i ett andra datacenter som finns i samma region som den primära platsen. Skrivskyddad åtkomst är tillgänglig från den sekundära platsen, om geo-redundant replikering med läsbehörighet är aktiverad för ditt lagringskonto.

get_table_service_stats(timeout=None)

Parametrar

Name	Description
timeout	int Tidsgränsparametern uttrycks i sekunder. standardvärde: None

Returer

Typ	Description
ServiceStats	Statistik för tabelltjänsten.

insert_entity

Infogar en ny entitet i tabellen. Genererar om en entitet med samma PartitionKey och RowKey redan finns.

När du infogar en entitet i en tabell måste du ange värden för systemegenskaperna PartitionKey och RowKey. Tillsammans utgör dessa egenskaper primärnyckeln och måste vara unika i tabellen. Både Värdena PartitionKey och RowKey måste vara strängvärden. varje nyckelvärde kan vara upp till 64 kB stort. Om du använder ett heltalsvärde för nyckelvärdet bör du konvertera heltalet till en sträng med fast bredd eftersom de är kanoniskt sorterade. Du bör till exempel konvertera värdet 1 till 0000001 för att säkerställa korrekt sortering.

insert_entity(table_name, entity, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som entiteten ska infogas i.
entity Obligatorisk	<xref:azure.storage.table.models.Entity> Entiteten som ska infogas. Kan vara en dikta eller ett entitetsobjekt. Måste innehålla en PartitionKey och en RowKey.
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
str	Etag för den infogade entiteten.

insert_or_merge_entity

Sammanfogar en befintlig entitet eller infogar en ny entitet om den inte finns i tabellen.

Om insert_or_merge_entity används för att sammanfoga en entitet behålls alla egenskaper från den tidigare entiteten om begäran inte definierar eller inkluderar dem.

insert_or_merge_entity(table_name, entity, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på den tabell där entiteten ska infogas eller sammanfogas.
entity Obligatorisk	<xref:azure.storage.table.models.Entity> Entiteten som ska infogas eller sammanfogas. Kan vara en dikta eller ett entitetsobjekt. Måste innehålla en PartitionKey och en RowKey.
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
str	Entitetens etag.

insert_or_replace_entity

Ersätter en befintlig entitet eller infogar en ny entitet om den inte finns i tabellen. Eftersom den här åtgärden kan infoga eller uppdatera en entitet kallas den även för en "upsert"-åtgärd.

Om insert_or_replace_entity används för att ersätta en entitet tas alla egenskaper från den tidigare entiteten bort om den nya entiteten inte definierar dem.

insert_or_replace_entity(table_name, entity, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på den tabell där entiteten ska infogas eller ersättas.
entity Obligatorisk	<xref:azure.storage.table.models.Entity> Entiteten som ska infogas eller ersättas. Kan vara en dikta eller ett entitetsobjekt. Måste innehålla en PartitionKey och en RowKey.
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
str	Entitetens etag.

list_tables

Returnerar en generator för att visa tabellerna. Generatorn följer lätt fortsättningstoken som returneras av tjänsten och stoppas när alla tabeller har returnerats eller num_results har nåtts.

Om num_results anges och kontot har fler än det antalet tabeller har generatorn ett ifyllt next_marker fält när det har slutförts. Den här markören kan användas för att skapa en ny generator om fler resultat önskas.

list_tables(num_results=None, marker=None, timeout=None)

Parametrar

Name	Description
num_results	int Det maximala antalet tabeller som ska returneras. standardvärde: None
marker	<xref:obj> Ett täckande fortsättningsobjekt. Det här värdet kan hämtas från fältet next_marker för ett tidigare generatorobjekt om num_results har angetts och generatorn har räknat upp resultat. Om det anges börjar den här generatorn returnera resultat från den punkt där den tidigare generatorn stoppades. standardvärde: None
timeout	int Serverns timeout uttryckt i sekunder. Den här funktionen kan göra flera anrop till tjänsten, i vilket fall det angivna tidsgränsvärdet tillämpas på varje enskilt anrop. standardvärde: None

Returer

Typ	Description
ListGenerator:	En generator som producerar <xref:azure.cosmosdb.table.common.models.table.Table> objekt.

merge_entity

Uppdateringar en befintlig entitet genom att slå samman entitetens egenskaper. Utlöser om entiteten inte finns.

Den här åtgärden ersätter inte den befintliga entiteten som den update_entity åtgärden gör. Det går inte att ta bort en egenskap med merge_entity.

Alla egenskaper med null-värden ignoreras. Alla andra egenskaper uppdateras eller läggs till.

merge_entity(table_name, entity, if_match='*', timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som innehåller entiteten som ska sammanfogas.
entity Obligatorisk	<xref:azure.storage.table.models.Entity> Entiteten som ska sammanfogas. Kan vara en dikta eller ett entitetsobjekt. Måste innehålla en PartitionKey och en RowKey.
if_match	str Klienten kan ange ETag för entiteten på begäran för att jämföra med den ETag som underhålls av tjänsten för optimistisk samtidighet. Sammanslagningsåtgärden utförs endast om ETag som skickas av klienten matchar värdet som upprätthålls av servern, vilket indikerar att entiteten inte har ändrats sedan den hämtades av klienten. Om du vill framtvinga en ovillkorlig sammanslagning anger du If-Match till jokertecknet (*). standardvärde: *
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
str	Entitetens etag.

query_entities

Returnerar en generator för att visa entiteterna i den angivna tabellen. Generatorn följer lätt de fortsättningstoken som returneras av tjänsten och stoppas när alla entiteter har returnerats eller num_results har nåtts.

Om num_results anges och kontot har fler än det antalet entiteter har generatorn ett ifyllt next_marker fält när det har slutförts. Den här markören kan användas för att skapa en ny generator om fler resultat önskas.

query_entities(table_name, filter=None, select=None, num_results=None, marker=None, accept='application/json;odata=minimalmetadata', property_resolver=None, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som ska frågas.
filter	str Returnerar endast entiteter som uppfyller det angivna filtret. Observera att högst 15 diskreta jämförelser tillåts inom en $filter sträng. Mer http://msdn.microsoft.com/en-us/library/windowsazure/dd894031.aspx information om hur du skapar filter finns i . standardvärde: None
select	str Returnerar endast önskade egenskaper för en entitet från uppsättningen. standardvärde: None
num_results	int Det maximala antalet entiteter som ska returneras. standardvärde: None
marker	<xref:obj> Ett täckande fortsättningsobjekt. Det här värdet kan hämtas från fältet next_marker för ett tidigare generatorobjekt om max_results har angetts och generatorn har räknat upp resultat. Om det anges börjar den här generatorn returnera resultat från den punkt där den tidigare generatorn stoppades. standardvärde: None
accept	str Anger den godkända innehållstypen för svarsnyttolasten. Se <xref:azure.storage.table.models.TablePayloadFormat> för möjliga värden. standardvärde: application/json;odata=minimalmetadata
property_resolver	<xref:func>(<xref:pk>, <xref:rk>, <xref:prop_name>, <xref:prop_value>, <xref:service_edm_type>) En funktion som ger partitionsnyckeln, radnyckeln, egenskapsnamnet, egenskapsvärdet och egenskapen EdmType om den returneras av tjänsten, returnerar egenskapens EdmType. Används vanligtvis om accept är inställt på JSON_NO_METADATA. standardvärde: None
timeout	int Serverns timeout uttryckt i sekunder. Den här funktionen kan göra flera anrop till tjänsten, i vilket fall det angivna tidsgränsvärdet tillämpas på varje enskilt anrop. standardvärde: None

Returer

Typ	Description
ListGenerator	En generator som producerar <xref:azure.storage.table.models.Entity> objekt.

set_proxy

Anger proxyserverns värd och port för HTTP CONNECT-tunnlar.

set_proxy(host, port, user=None, password=None)

Parametrar

Name	Description
host Obligatorisk	str Proxyns adress. Ex: "192.168.0.100"
port Obligatorisk	int Proxyns port. Ex: 6000
user	str Användare för proxyauktorisering. standardvärde: None
password	str Lösenord för proxyauktorisering. standardvärde: None

set_table_acl

Anger lagrade åtkomstprinciper för tabellen som kan användas med signaturer för delad åtkomst.

När du anger behörigheter för en tabell ersätts de befintliga behörigheterna. Om du vill uppdatera tabellens behörigheter anropar get_table_acl du för att hämta alla åtkomstprinciper som är associerade med tabellen, ändrar åtkomstprincipen som du vill ändra och anropar sedan den här funktionen med den fullständiga datauppsättningen för att utföra uppdateringen.

När du upprättar en lagrad åtkomstprincip i en tabell kan det ta upp till 30 sekunder att börja gälla. Under det här intervallet genererar en signatur för delad åtkomst som är associerad med den lagrade åtkomstprincipen en <xref:azure.cosmosdb.table.tableservice.AzureHttpError> tills åtkomstprincipen blir aktiv.

set_table_acl(table_name, signed_identifiers=None, timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på en befintlig tabell.
signed_identifiers	dict(str, AccessPolicy) En ordlista med åtkomstprinciper som ska associeras med tabellen. Ordlistan kan innehålla upp till 5 element. En tom ordlista rensar åtkomstprinciperna som angetts för tjänsten. standardvärde: None
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

set_table_service_properties

Anger egenskaperna för ett lagringskontos tabelltjänst, inklusive Azure Lagringsanalys. Om ett element (t.ex. loggning) lämnas som Ingen bevaras de befintliga inställningarna för tjänsten för den funktionen. Mer information om Azure Lagringsanalys finns i https://msdn.microsoft.com/en-us/library/azure/hh343270.aspx.

set_table_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, timeout=None)

Parametrar

Name	Description
logging	Logging Loggningsinställningarna tillhandahåller begärandeloggar. standardvärde: None
hour_metrics	Metrics Inställningarna för timmått ger en sammanfattning av begärandestatistik grupperad efter API i timaggregeringar för tabeller. standardvärde: None
minute_metrics	Metrics Minutmåttinställningarna tillhandahåller begärandestatistik för varje minut för tabeller. standardvärde: None
cors	list(CorsRule) Du kan inkludera upp till fem CorsRule-element i listan. Om en tom lista anges tas alla CORS-regler bort och CORS inaktiveras för tjänsten. Detaljerad information om CORS-regler och utvärderingslogik finns i https://msdn.microsoft.com/en-us/library/azure/dn535601.aspx. standardvärde: None
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

update_entity

Uppdateringar en befintlig entitet i en tabell. Utlöser om entiteten inte finns. Åtgärden update_entity ersätter hela entiteten och kan användas för att ta bort egenskaper.

update_entity(table_name, entity, if_match='*', timeout=None)

Parametrar

Name	Description
table_name Obligatorisk	str Namnet på tabellen som innehåller entiteten som ska uppdateras.
entity Obligatorisk	<xref:azure.storage.table.models.Entity> Entiteten som ska uppdateras. Kan vara en dikta eller ett entitetsobjekt. Måste innehålla en PartitionKey och en RowKey.
if_match	str Klienten kan ange ETag för entiteten på begäran för att jämföra med den ETag som underhålls av tjänsten för optimistisk samtidighet. Uppdateringsåtgärden utförs endast om ETag som skickas av klienten matchar värdet som underhålls av servern, vilket indikerar att entiteten inte har ändrats sedan den hämtades av klienten. Om du vill framtvinga en ovillkorlig uppdatering anger du If-Match till jokertecknet (*). standardvärde: *
timeout	int Serverns timeout uttryckt i sekunder. standardvärde: None

Returer

Typ	Description
str	Entitetens etag.

Attribut

protocol

request_session

socket_timeout