tables Pacote

  • Referência

Pacote

aio

Classes

AccountSasPermissions

AccountSasPermissions classe a utilizar com generate_account_sas
EntityProperty

Uma propriedade de entidade. Utilizado para definir EdmType explicitamente quando necessário.

Os valores que requerem escrita explícita são GUID, INT64 e BINARY. Outros EdmTypes podem ser explicitamente criados como objetos EntityProperty, mas não precisam de ser. Por exemplo, o seguinte, com ambas as propriedades escritas string na entidade:


   entity = TableEntity()
   entity.a = 'b'
   entity.x = EntityProperty('y', EdmType.STRING)
RequestTooLargeError

Uma resposta de erro com o código de estado 413 – Entidade de Pedido Demasiado Grande
ResourceTypes

Especifica os tipos de recursos que estão acessíveis com a SAS da conta.
TableAccessPolicy

Classe de Política de Acesso utilizada pelo conjunto e obter métodos de política de acesso.

Uma política de acesso armazenada pode especificar a hora de início, a hora de expiração e as permissões das Assinaturas de Acesso Partilhado com as quais está associada. Consoante a forma como pretende controlar o acesso ao recurso, pode especificar todos estes parâmetros na política de acesso armazenada e omiti-los a partir do URL da Assinatura de Acesso Partilhado. Ao fazê-lo, pode modificar o comportamento da assinatura associada em qualquer altura, bem como revogá-lo. Em alternativa, pode especificar um ou mais dos parâmetros da política de acesso na política de acesso armazenada e os outros no URL. Por fim, pode especificar todos os parâmetros no URL. Neste caso, pode utilizar a política de acesso armazenada para revogar a assinatura, mas não para modificar o respetivo comportamento.

Em conjunto, a Assinatura de Acesso Partilhado e a política de acesso armazenado têm de incluir todos os campos necessários para autenticar a assinatura. Se existirem campos necessários em falta, o pedido falhará. Da mesma forma, se for especificado um campo no URL da Assinatura de Acesso Partilhado e na política de acesso armazenada, o pedido falhará com o código de estado 400 (Pedido Incorreto).
TableAnalyticsLogging

Definições do Registo do Azure Analytics.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.
TableClient

Um cliente para interagir com uma Tabela específica numa conta de Tabelas do Azure.

Criar TableClient a partir de uma Credencial.
TableCorsRule

O CORS é uma funcionalidade HTTP que permite a execução de uma aplicação Web num domínio para aceder a recursos noutro domínio. Os browsers implementam uma restrição de segurança conhecida como política de origem idêntica, que impede uma página Web de chamar APIs num domínio diferente. O CORS é uma forma segura de permitir que um domínio (o domínio de origem) chame APIs de outro domínio.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.
TableEntity

Um dicionário entidade com metadados adicionais
TableItem

Representa um TableItem do Azure. Devolvido por TableServiceClient.list_tables e TableServiceClient.query_tables.
TableMetrics

Um resumo das estatísticas de pedido agrupadas por API em agregações de hora ou minuto.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.
TableRetentionPolicy

A política de retenção que determina durante quanto tempo os dados associados devem persistir.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.
TableSasPermissions
TableServiceClient

Um cliente para interagir com o Serviço tabela ao nível da conta.

Este cliente fornece operações para obter e configurar as propriedades da conta, bem como listar, criar e eliminar tabelas na conta. Para operações relacionadas com uma tabela específica, um cliente para esta entidade pode ser obtido com a get_table_client função .

Criar TabelasBaseCliente a partir de uma Credencial.
TableTransactionError

Existe uma falha nas operações de transação.

Enumerações

EdmType

Utilizado por EntityProperty para representar o tipo da propriedade de entidade a armazenar pelo serviço Tabela.
SASProtocol
TableErrorCode
TransactionOperation
UpdateMode

Funções

generate_account_sas

Gera uma assinatura de acesso partilhado para o serviço de tabelas. Utilize a assinatura devolvida com o parâmetro sas_token de TableService.

generate_account_sas(credential: AzureNamedKeyCredential, resource_types: ResourceTypes, permission: str | AccountSasPermissions, expiry: datetime | str, **kwargs) -> str

Parâmetros

credential
AzureNamedKeyCredential
Necessário

Credencial para a conta do Azure

resource_types
ResourceTypes
Necessário

Especifica os tipos de recursos que estão acessíveis com a SAS da conta.

permission
str ou AccountSasPermissions
Necessário

As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.

expiry
datetime ou str
Necessário

O momento em que a assinatura de acesso partilhado se torna inválida. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.

start
datetime ou str

O momento em que a assinatura de acesso partilhado se torna válida. Se for omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.

ip_address_or_range
str

Especifica um endereço IP ou um intervalo de endereços IP a partir do qual aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.

protocol
str ou SASProtocol

Especifica o protocolo permitido para um pedido feito.

Devoluções

Um token de Assinatura de Acesso Partilhado (sas).

Tipo de retorno

str

generate_table_sas

Gera uma assinatura de acesso partilhado para o serviço de tabelas. Utilize a assinatura devolvida com o parâmetro sas_token de TableService.

generate_table_sas(credential: AzureNamedKeyCredential, table_name: str, **kwargs) -> str

Parâmetros

credential
AzureNamedKeyCredential
Necessário

Credencial utilizada para criar a Assinatura de Acesso Partilhado

table_name
str
Necessário

Nome da tabela

permission
TableSasPermissions

As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.

expiry
datetime ou str

O momento em que a assinatura de acesso partilhado se torna inválida. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.

start
datetime ou str

O momento em que a assinatura de acesso partilhado se torna válida. Se for omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.

ip_address_or_range
str

Especifica um endereço IP ou um intervalo de endereços IP a partir do qual aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.

policy_id
str

ID da política de acesso.

protocol
str ou SASProtocol

Especifica o protocolo permitido para um pedido feito.

start_rk
str

Tecla de linha inicial

start_pk
str

A iniciar chave de partição

end_rk
str

Tecla de linha de fim

end_pk
str

Terminar chave de partição

Devoluções

Um token de Assinatura de Acesso Partilhado (sas).

Tipo de retorno

str