您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az storage entity

管理表存储实体。

命令

az storage entity delete

删除表中的现有实体。

az storage entity insert

将实体插入表中。

az storage entity merge

通过合并实体的属性来更新现有实体。

az storage entity query

列出满足查询的实体。

az storage entity replace

更新表中的现有实体。

az storage entity show

从指定的表中获取实体。

az storage entity delete

删除表中的现有实体。

如果该实体不存在,则引发。 成功删除实体后,该实体将立即标记为删除,并且客户端将不再能够访问该实体。 稍后将在垃圾回收期间从表服务中删除该实体。

az storage entity delete --partition-key
                         --row-key
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--connection-string]
                         [--if-match]
                         [--sas-token]
                         [--subscription]
                         [--timeout]

必需参数

--partition-key

实体的 PartitionKey。

--row-key

实体的 RowKey。

--table-name -t

包含要删除的实体的表的名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量: AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌一起使用。 如果两者都不存在,则该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行大量存储命令,则可能会遇到 API 配额。

--connection-string

存储帐户连接字符串。 环境变量: AZURE_STORAGE_CONNECTION_STRING。

--if-match

客户端可以在请求中指定实体的 ETag,以与服务为乐观并发目的维护的 ETag 进行比较。 仅当客户端发送的 ETag 与服务器维护的值匹配(指示实体自被客户端检索以来未修改)时,才执行删除操作。 若要强制执行无条件删除,请将 If-Match 设置为 (*) 的通配符。

--sas-token

(SAS) 的共享访问签名。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_SAS_TOKEN。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

az storage entity insert

将实体插入表中。

az storage entity insert --entity
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--connection-string]
                         [--if-exists {fail, merge, replace}]
                         [--sas-token]
                         [--subscription]
                         [--timeout]

示例

将实体插入表中。 (自动生成)

az storage entity insert --connection-string $connectionString --entity PartitionKey=AAA RowKey=BBB Content=ASDF2 --if-exists fail --table-name MyTable

必需参数

--entity -e

键 = 值对的空格分隔列表。 必须包含 PartitionKey 和 RowKey。

--table-name -t

要向其中插入实体的表的名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量: AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌一起使用。 如果两者都不存在,则该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行大量存储命令,则可能会遇到 API 配额。

--connection-string

存储帐户连接字符串。 环境变量: AZURE_STORAGE_CONNECTION_STRING。

--if-exists

指定的 PartitionKey 和 RowKey 的实体已存在时的行为。

接受的值: fail, merge, replace
默认值: fail
--sas-token

(SAS) 的共享访问签名。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_SAS_TOKEN。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

服务器超时,以秒为单位。

az storage entity merge

通过合并实体的属性来更新现有实体。

如果该实体不存在,则引发。 此操作不会替换现有实体,因为 update_entity 操作会。 无法使用 merge_entity 删除属性。 将忽略任何具有 null 值的属性。 所有其他属性都将被更新或添加。

az storage entity merge --entity
                        --table-name
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--if-match]
                        [--sas-token]
                        [--subscription]
                        [--timeout]

必需参数

--entity -e

要合并的实体。 可以是 dict 或实体对象。 必须包含 PartitionKey 和 RowKey。

--table-name -t

包含要合并的实体的表的名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量: AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌一起使用。 如果两者都不存在,则该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行大量存储命令,则可能会遇到 API 配额。

--connection-string

存储帐户连接字符串。 环境变量: AZURE_STORAGE_CONNECTION_STRING。

--if-match

客户端可以在请求中指定实体的 ETag,以与服务为乐观并发目的维护的 ETag 进行比较。 仅当客户端发送的 ETag 与服务器维护的值匹配时,才会执行 merge 操作,这表示在客户端检索到实体后未对其进行修改。 若要强制执行无条件合并,请将 If-Match 设置为 (*) 的通配符。

--sas-token

(SAS) 的共享访问签名。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_SAS_TOKEN。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

az storage entity query

列出满足查询的实体。

az storage entity query --table-name
                        [--accept {full, minimal, none}]
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--filter]
                        [--marker]
                        [--num-results]
                        [--sas-token]
                        [--select]
                        [--subscription]
                        [--timeout]

示例

列出满足查询的实体。 (自动生成)

az storage entity query --table-name MyTable

必需参数

--table-name -t

要查询的表的名称。

可选参数

--accept

指定要包含在响应有效负载中的元数据量。

接受的值: full, minimal, none
默认值: minimal
--account-key

存储帐户密钥。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量: AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌一起使用。 如果两者都不存在,则该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行大量存储命令,则可能会遇到 API 配额。

--connection-string

存储帐户连接字符串。 环境变量: AZURE_STORAGE_CONNECTION_STRING。

--filter

仅返回满足指定筛选器的实体。 请注意,$filter 字符串中不允许超过15个离散比较。 http://msdn.microsoft.com/en-us/library/windowsazure/dd894031.aspx有关构造筛选器的详细信息,请参阅。

--marker

键 = 值对的空格分隔列表。 必须包含 nextpartitionkey 和 nextrowkey。

--num-results

要返回的最大实体数。

--sas-token

(SAS) 的共享访问签名。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_SAS_TOKEN。

--select

要为每个实体返回的以空格分隔的属性列表。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

az storage entity replace

更新表中的现有实体。

如果该实体不存在,则引发。 Update_entity 操作将替换整个实体,可用于删除属性。

az storage entity replace --entity
                          --table-name
                          [--account-key]
                          [--account-name]
                          [--connection-string]
                          [--if-match]
                          [--sas-token]
                          [--subscription]
                          [--timeout]

必需参数

--entity -e

要更新的实体。 可以是 dict 或实体对象。 必须包含 PartitionKey 和 RowKey。

--table-name -t

包含要更新的实体的表的名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量: AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌一起使用。 如果两者都不存在,则该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行大量存储命令,则可能会遇到 API 配额。

--connection-string

存储帐户连接字符串。 环境变量: AZURE_STORAGE_CONNECTION_STRING。

--if-match

客户端可以在请求中指定实体的 ETag,以与服务为乐观并发目的维护的 ETag 进行比较。 仅当客户端发送的 ETag 值与服务器维护的值匹配(指示实体自被客户端检索以来未修改)时,才执行更新操作。 要强制进行无条件更新,请将 If-Match 设置为 () 的通配符 * 。

--sas-token

(SAS) 的共享访问签名。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_SAS_TOKEN。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

az storage entity show

从指定的表中获取实体。

如果该实体不存在,则引发。

az storage entity show --partition-key
                       --row-key
                       --table-name
                       [--accept]
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--query-examples]
                       [--sas-token]
                       [--select]
                       [--subscription]
                       [--timeout]

必需参数

--partition-key

实体的 PartitionKey。

--row-key

实体的 RowKey。

--table-name -t

要从中获取实体的表的名称。

可选参数

--accept

指定响应负载已接受的内容类型。 有关可能的值,请参阅 TablePayloadFormat。

默认值: application/json;odata=minimalmetadata
--account-key

存储帐户密钥。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量: AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌一起使用。 如果两者都不存在,则该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行大量存储命令,则可能会遇到 API 配额。

--connection-string

存储帐户连接字符串。 环境变量: AZURE_STORAGE_CONNECTION_STRING。

--query-examples

建议 JMESPath 字符串。 可以复制其中一个查询,然后将其粘贴在双引号内,以查看结果。 您可以添加一个或多个位置关键字,以便我们可以根据这些关键字提供建议。

--sas-token

(SAS) 的共享访问签名。 必须与存储帐户名称一起使用。 环境变量: AZURE_STORAGE_SAS_TOKEN。

--select

要为每个实体返回的以空格分隔的属性列表。

--subscription

订阅的名称或 ID。 您可以使用配置默认订阅 az account set -s NAME_OR_ID

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。