tables 套件

  • 參考

套件

aio

類別

AccountSasPermissions

AccountSasPermissions 要與generate_account_sas搭配使用的類別
EntityProperty

實體屬性。 用來在必要時明確設定 EdmType 。

需要明確輸入的值是 GUID、INT64 和 BINARY。 其他 EdmTypes 可能會明確建立為 EntityProperty 物件，但不需要。 例如，下列兩者都會在實體上建立 STRING 類型屬性：


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

狀態碼為 413 的錯誤回應 - 要求實體太大
ResourceTypes

指定帳戶 SAS 可存取的資源類型。
TableAccessPolicy

集合所使用的存取原則類別，並取得存取原則方法。

儲存的存取原則可以指定其相關聯之共用存取簽章的開始時間、到期時間及權限。 根據您想要如何控制資源的存取權，您可以在預存存取原則內指定所有這些參數，並從共用存取簽章的 URL 中省略這些參數。 這樣做可讓您隨時修改相關聯的簽章行為，以及將它撤銷。 您也可以在儲存的存取原則中指定一個或多個存取原則參數，然後在 URL 上指定其他參數。 最後，您可以在 URL 上指定所有參數。 在此情況下，您可以使用儲存的存取原則撤銷簽章，但不修改其行為。

共用存取簽章和預存存取原則必須包含驗證簽章所需的所有欄位。 如果遺漏任何必要的欄位，要求將會失敗。 同樣地，如果同時在共用存取簽章 URL 和預存存取原則中指定某個欄位，則要求會失敗，並顯示狀態碼 400 (不正確的要求)。
TableAnalyticsLogging

Azure 分析記錄設定。

必須填入所有必要的參數，才能傳送至 Azure。
TableClient

要與 Azure 資料表帳戶中特定資料表互動的用戶端。

從認證建立 TableClient。
TableCorsRule

CORS 是一項 HTTP 功能，可讓 Web 應用程式在某個網域下執行，以存取其他網域中的資源。 網頁瀏覽器會實作稱為同源原則的安全性限制，其可防止網頁呼叫不同網域中的 API；CORS 則提供了一個安全的方式，可讓一個網域 (原始網域) 能夠呼叫其他網域中的 API。

必須填入所有必要的參數，才能傳送至 Azure。
TableEntity

具有其他中繼資料的實體字典
TableItem

代表 Azure TableItem。 由 TableServiceClient.list_tables 和 TableServiceClient.query_tables 傳回。
TableMetrics

依 API 分組的要求統計資料摘要，以小時或分鐘匯總為單位。

必須填入所有必要的參數，才能傳送至 Azure。
TableRetentionPolicy

決定相關聯資料應保存多久的保留原則。

必須填入所有必要的參數，才能傳送至 Azure。
TableSasPermissions
TableServiceClient

在帳戶層級與資料表服務互動的用戶端。

此用戶端提供作業來擷取和設定帳戶屬性，以及列出、建立和刪除帳戶內的資料表。 對於與特定資料表相關的作業，可以使用 函式擷取此實體的 get_table_client 用戶端。

從認證建立 TablesBaseClient。
TableTransactionError

交易作業發生失敗。

列舉

EdmType

EntityProperty用來表示資料表服務所要儲存之實體屬性的類型。
SASProtocol
TableErrorCode
TransactionOperation
UpdateMode

函數

generate_account_sas

產生資料表服務的共用存取簽章。 使用傳回的簽章搭配 TableService 的 sas_token 參數。

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

參數

credential
AzureNamedKeyCredential
必要

Azure 帳戶的認證

resource_types
ResourceTypes
必要

指定帳戶 SAS 可存取的資源類型。

permission
str 或 AccountSasPermissions
必要

這些權限與共用存取簽章相關聯。 使用者只能執行這些權限允許的作業。 除非指定參考包含此欄位之預存存取原則的識別碼，否則為必要專案。 如果已在相關聯的預存存取原則中指定，則必須省略此欄位。

expiry
datetime 或 str
必要

共用存取簽章變成不正確時間。 除非指定參考包含此欄位之預存存取原則的識別碼，否則為必要專案。 如果已在相關聯的預存存取原則中指定，則必須省略此欄位。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期，則會假設為 UTC。

start
datetime 或 str

共用存取簽章生效的時間。 如果省略，此呼叫的開始時間會假設為儲存體服務收到要求的時間。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期，則會假設為 UTC。

ip_address_or_range
str

指定要接受要求的 IP 位址或 IP 位址範圍。 如果要求的來源 IP 位址不符合 SAS 權杖上指定的 IP 位址或位址範圍，則不會驗證要求。 例如，在 SAS 上指定 sip=168.1.5.65 或 sip=168.1.5.60-168.1.5.70 會限制這些 IP 位址的要求。

protocol
str 或 SASProtocol

指定要求允許的通訊協定。

傳回

共用存取簽章 (sas) 權杖。

傳回類型

str

generate_table_sas

產生資料表服務的共用存取簽章。 使用傳回的簽章搭配 TableService 的 sas_token 參數。

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

參數

credential
AzureNamedKeyCredential
必要

用於建立共用存取簽章的認證

table_name
str
必要

資料表名稱

permission
TableSasPermissions

這些權限與共用存取簽章相關聯。 使用者只能執行這些權限允許的作業。 除非指定參考包含此欄位之預存存取原則的識別碼，否則為必要專案。 如果已在相關聯的預存存取原則中指定，則必須省略此欄位。

expiry
datetime 或 str

共用存取簽章變成不正確時間。 除非指定參考包含此欄位之預存存取原則的識別碼，否則為必要專案。 如果已在相關聯的預存存取原則中指定，則必須省略此欄位。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期，則會假設為 UTC。

start
datetime 或 str

共用存取簽章生效的時間。 如果省略，此呼叫的開始時間會假設為儲存體服務收到要求的時間。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期，則會假設為 UTC。

ip_address_or_range
str

指定要接受要求的 IP 位址或 IP 位址範圍。 如果要求的來源 IP 位址不符合 SAS 權杖上指定的 IP 位址或位址範圍，則不會驗證要求。 例如，在 SAS 上指定 sip=168.1.5.65 或 sip=168.1.5.60-168.1.5.70 會限制這些 IP 位址的要求。

policy_id
str

存取原則識別碼。

protocol
str 或 SASProtocol

指定要求允許的通訊協定。

start_rk
str

啟動資料列索引鍵

start_pk
str

啟動分割區索引鍵

end_rk
str

結束資料列索引鍵

end_pk
str

結束分割區索引鍵

傳回

共用存取簽章 (sas) 權杖。

傳回類型

str