Share via


az storage table

管理 NoSQL 索引鍵/值儲存體。

命令

名稱 Description 類型 狀態
az storage table create

在儲存體帳戶中建立新的資料表。

核心 GA
az storage table delete

刪除指定的資料表及其包含的任何資料。

核心 GA
az storage table exists

傳回布林值,指出資料表是否存在。

核心 GA
az storage table generate-sas

產生資料表的共用存取簽章。

核心 GA
az storage table list

列出儲存體帳戶中的資料表。

核心 GA
az storage table policy

管理儲存體資料表的共用存取原則。

核心 GA
az storage table policy create

在包含的物件上建立預存存取原則。

核心 GA
az storage table policy delete

刪除包含物件的預存存取原則。

核心 GA
az storage table policy list

列出包含物件的預存存取原則。

核心 GA
az storage table policy show

在包含的物件上顯示預存存取原則。

核心 GA
az storage table policy update

在包含的物件上設定預存存取原則。

核心 GA
az storage table stats

擷取與資料表服務複寫相關的統計資料。

核心 GA

az storage table create

在儲存體帳戶中建立新的資料表。

az storage table create --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-on-exist]
                        [--sas-token]
                        [--table-endpoint]

必要參數

--name -n

資料表名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--fail-on-exist

如果資料表已經存在,則擲回例外狀況。

預設值: False
--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--table-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage table delete

刪除指定的資料表及其包含的任何資料。

az storage table delete --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-not-exist]
                        [--sas-token]
                        [--table-endpoint]

必要參數

--name -n

資料表名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--fail-not-exist

如果資料表不存在,則擲回例外狀況。

預設值: False
--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--table-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage table exists

傳回布林值,指出資料表是否存在。

az storage table exists --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--sas-token]
                        [--table-endpoint]

必要參數

--name -n

資料表名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--table-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage table generate-sas

產生資料表的共用存取簽章。

az storage table generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--connection-string]
                              [--end-pk]
                              [--end-rk]
                              [--expiry]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--start]
                              [--start-pk]
                              [--start-rk]
                              [--table-endpoint]

必要參數

--name -n

資料表名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--end-pk

此共用存取簽章可存取的資料分割索引鍵上限。 endpk 必須伴隨 endrk。 索引鍵值是內含的。 如果省略,則無法存取資料表實體的上限。

--end-rk

此共用存取簽章可存取的資料列索引鍵上限。 endpk 必須伴隨 endrk。 索引鍵值是內含的。 如果省略,則無法存取資料表實體的上限。

--expiry

指定 SAS 不正確 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存存取原則,請勿使用 。

--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略,則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的 IP 位址或 IP 位址範圍。 僅支援 IPv4 樣式位址。

--permissions

SAS 授與的許可權。 允許的值:(r)ead/query (a)dd (u)pdate (d)elete。 如果以指定此值的 --id 參考預存存取原則,請勿使用 。 可以合併。

--policy-name

資料表 ACL 內預存存取原則的名稱。

--start

指定 SAS 生效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存存取原則,請勿使用 。 預設為要求的時間。

--start-pk

此共用存取簽章可存取的最低分割區索引鍵。 startpk 必須伴隨 startrk。 索引鍵值是內含的。 如果省略,則資料表實體上沒有可存取的下限。

--start-rk

此共用存取簽章可存取的最低資料列索引鍵。 startpk 必須伴隨 startrk。 索引鍵值是內含的。 如果省略,則資料表實體上沒有可存取的下限。

--table-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage table list

列出儲存體帳戶中的資料表。

az storage table list [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--connection-string]
                      [--marker]
                      [--num-results]
                      [--sas-token]
                      [--show-next-marker]
                      [--table-endpoint]

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--marker

字串值,識別要隨著下一個清單作業傳回之容器清單的部分。 如果清單作業未傳回剩餘的所有容器,則此作業會傳迴響應主體內的 NextMarker 值,以與目前頁面一起列出。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--num-results

要傳回的資料表數目上限。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--show-next-marker

指定時,在結果中顯示 nextMarker。

--table-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage table stats

擷取與資料表服務複寫相關的統計資料。

只有在帳戶啟用讀取權限異地備援複寫時,才能在次要位置端點上使用。 :return: 服務統計資料的字典:rtype: Dict[str, object] :raises: :class: ~azure.core.exceptions.HttpResponseError:

az storage table stats [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--sas-token]
                       [--table-endpoint]

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--table-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。