Azure 表存储

Azure 表存储是一项服务,用于在云中存储结构化 NoSQL 数据,并提供无架构设计的关键/属性存储。 登录到存储帐户以创建、更新和查询表等。

此连接器在以下产品和区域中可用:

服务 Class 区域
Copilot Studio 高级 所有 Power Automate 区域
逻辑应用程序 标准 所有 逻辑应用区域
Power Apps - 不可用
Power Automate 高级 所有 Power Automate 区域
联系人​​
Name Microsoft
URL Microsoft LogicApps 支持
Microsoft Power Automate 支持
连接器元数据
发布者 Microsoft
Website https://azure.microsoft.com/services/storage/tables/

若要使用此集成,需要访问 Azure 存储帐户。 可在此处找到详细信息。 尝试建立连接时,系统会提示你提供存储帐户名称和存储密钥。 可以在 URL 中找到存储帐户的名称,例如,如果 URL 是 https://myaccount.table.core.windows.net 帐户名称,则帐户名称将为“myaccount”。 如果你有多个帐户,请提供要使用的帐户并选择“ 创建”。 如果在创建过程中看到错误,请检查帐户名称和密钥,然后重试。 现在,你已准备好开始使用此集成。

已知问题和限制

  1. 如果逻辑应用位于同一区域中,则无法直接访问防火墙后面的存储帐户。 解决方法是,可以在不同的区域中设置逻辑应用和存储帐户。 有关启用从 Azure 逻辑应用访问防火墙后面的存储帐户的详细信息,请参阅 防火墙后面的访问存储帐户

托管标识身份验证和 Azure 表存储连接器

目前,托管标识身份验证仅在逻辑应用中受支持。 按照以下步骤使用它连接到 Azure 表存储数据:

  1. 创建 Azure 托管标识
  2. 授予对 Azure Blob 资源的标识访问权限。 有关更多详细信息,请访问 授权使用 Microsoft Entra ID 访问 blob
  3. 如果使用用户分配的标识,请将逻辑应用与托管标识相关联
    1. 导航到将使用托管标识的逻辑应用。
    2. 在边栏选项卡的“设置”部分下,单击 Identity
    3. 转到 User assigned 选项卡并单击 Add
    4. 选择要使用的托管标识,然后单击 Add

有关在逻辑应用中使用托管标识进行身份验证的详细信息,请访问 在 Azure 逻辑应用中使用托管标识对 Azure 资源的访问进行身份验证

Microsoft Entra ID 身份验证的已知限制

由于当前的身份验证管道限制,Microsoft与 Azure 表存储Microsoft Entra ID 连接不支持 Entra ID 来宾用户。 使用 Microsoft Entra ID 或托管标识身份验证 时,仅支持 V2作。 弃用的作将继续使用 Access Key 身份验证,但如果 与 Microsoft Entra ID 或托管标识连接一起使用,将失败

使用表终结点连接到 Azure 表存储连接器

创建“访问密钥”连接或使用 V2作时输入完整的 Azure 存储表终结点。

  • 对于“访问密钥”身份验证,请在参数上 Azure Storage account name or table endpoint 输入完整的 Azure 存储表终结点。

    • 将“V2”作与“访问密钥”身份验证结合使用时,还必须在 storageAccountName 参数中提供表终结点。
  • 对于“V2”作,请在参数上 storageAccountName 输入完整的 Azure 存储表终结点。

  • 必须提供完整的终结点,包括架构,例如:

    • https://account.table.core.windows.net/
    • https://account-secondary.table.core.windows.net/ (如果连接到辅助终结点)
    • 相对路径(例如, account.table.core.windows.net)将被拒绝。

获取给定存储帐户的 Azure 存储表终结点

可通过多种方式获取此表终结点:

  • 使用 Azure 门户

    1. 在 azure Microsoft,导航到要连接的 Azure 存储帐户
    2. Settings “部分”下(左边栏选项卡),单击 Endpoints
    3. 表终结点将在文本框中的“表服务table service”下。
  • 使用 存储帐户 - 获取属性 REST API 调用

    1. 获取 Azure 存储帐户 subscription Idresource group name
    2. 导航到 存储帐户 - 获取属性
    3. Try it单击 HTTP 调用右上角的按钮
    4. 登录(用户应有权访问存储帐户)
    5. 选择 Azure 存储帐户所在的 Azure 租户
    6. 输入 Azure 存储的帐户名称、资源组名称,并选择存储帐户所在的订阅。
    7. 点击 Run
    8. 表终结点将位于 table 响应对象下 primaryEndpoints 的属性上

正在创建连接

连接器支持以下身份验证类型:

访问密钥 提供 Azure 存储帐户名称(或表终结点)和访问密钥以访问 Azure 表存储。 除 Azure 政府和国防部(DoD)以外的所有区域(Azure 政府和美国政府(GCC)和美国政府(GCC-High) 可共享
访问密钥 (Azure 政府版) 提供 Azure 存储帐户名称(或表终结点)和访问密钥以访问 Azure 表存储。 Azure 政府和国防部(DoD)仅在 Azure 政府和美国政府(GCC)和美国政府(GCC-High) 可共享
客户端证书身份验证 使用 PFX 证书和密码提供Microsoft Entra ID 凭据 所有区域 可共享
逻辑应用托管标识 使用托管标识创建连接 仅限 LOGICAPPS 可共享
Microsoft Entra ID 集成 使用 Microsoft Entra ID 访问 Azure 表存储。 除 Azure 政府和国防部(DoD)以外的所有区域(Azure 政府和美国政府(GCC)和美国政府(GCC-High) 不可共享
Microsoft Entra ID 集成(Azure 政府版) 使用 Microsoft Entra ID 访问 Azure 表存储。 Azure 政府和国防部(DoD)仅在 Azure 政府和美国政府(GCC)和美国政府(GCC-High) 不可共享
服务主体身份验证 使用 Microsoft Entra ID 应用程序进行服务主体身份验证。 所有区域 不可共享
默认值 [已弃用] 此选项仅适用于没有显式身份验证类型的较旧连接,并且仅用于向后兼容性。 所有区域 不可共享

访问密钥

身份验证 ID:keyBasedAuth

适用:除 Azure 政府和国防部(DoD)以外的所有区域(Azure 政府和美国政府(GCC)和美国政府(GCC-High)

提供 Azure 存储帐户名称(或表终结点)和访问密钥以访问 Azure 表存储。

这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name 类型 Description 必选
Azure 存储帐户名称或表终结点 字符串 Azure 存储帐户的名称或表终结点 True
共享存储密钥 securestring Azure 存储帐户的共享存储密钥 True

访问密钥 (Azure 政府版)

身份验证 ID:keyBasedAuth

适用:Azure 政府和国防部(DoD)仅在 Azure 政府和美国政府(GCC)和美国政府(GCC-High)

提供 Azure 存储帐户名称(或表终结点)和访问密钥以访问 Azure 表存储。

这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name 类型 Description 必选
Azure 存储帐户名称或表终结点 字符串 Azure 存储帐户的名称或表终结点 True
共享存储密钥 securestring Azure 存储帐户的共享存储密钥 True

客户端证书身份验证

身份验证 ID:certOauth

适用:所有区域

使用 PFX 证书和密码提供Microsoft Entra ID 凭据

这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name 类型 Description 必选
客户 ID 字符串 True
租户 字符串 True
客户端证书机密 clientCertificate 此应用程序允许的客户端证书机密 True

逻辑应用托管标识

身份验证 ID:managedIdentityAuth

适用:仅限 LOGICAPPS

使用托管标识创建连接

这是可共享的连接。 如果 Power App 与其他用户共享,则连接也会共享。 有关详细信息,请参阅 画布应用的连接器概述 - Power Apps |Microsoft Docs

Name 类型 Description 必选
托管身份 managedIdentity 使用托管标识登录 True

已集成 Microsoft Entra ID

身份验证 ID:tokenBasedAuth

适用:除 Azure 政府和国防部(DoD)以外的所有区域(Azure 政府和美国政府(GCC)和美国政府(GCC-High)

使用 Microsoft Entra ID 访问 Azure 表存储。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Microsoft Entra ID 集成(Azure 政府版)

身份验证 ID:tokenBasedAuth

适用:Azure 政府和国防部(DoD)仅在 Azure 政府和美国政府(GCC)和美国政府(GCC-High)

使用 Microsoft Entra ID 访问 Azure 表存储。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

服务主体身份验证

身份验证 ID:servicePrincipalAuth

适用:所有区域

使用 Microsoft Entra ID 应用程序进行服务主体身份验证。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
客户 ID 字符串 True
客户密钥 securestring True
租户 ID 字符串 True

默认值 [已弃用]

适用:所有区域

此选项仅适用于没有显式身份验证类型的较旧连接,并且仅用于向后兼容性。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
Azure 存储帐户名称或表终结点 字符串 Azure 存储帐户的名称或表终结点 True
共享存储密钥 securestring Azure 存储帐户的共享存储密钥 True

限制

名称 调用 续订期
每个连接的 API 调用数 1200 60 秒

操作

列出表 [已弃用]

此作已弃用。 请改用 列表表(V2 )。

此作列出帐户中的表。

列出表 (V2)

列出存储帐户的所有表。

创建表 [已弃用]

此作已弃用。 请改用“创建表”(V2)。

此作将表添加到存储帐户。

创建表 (V2)

此作将表添加到存储帐户。

删除实体 [已弃用]

此作已弃用。 请改用“删除实体”(V2)。

删除实体的作。

删除实体 (V2)

删除实体的作。

删除表 [已弃用]

此作已弃用。 请改用“删除表”(V2)。

删除表。

删除表 (V2)

删除表。

合并实体 [已弃用]

此作已弃用。 请改用合并实体(V2)。

将数据与表中的实体合并的作。

合并实体 (V2)

将数据与表中的实体合并的作。

插入实体 [已弃用]

此作已弃用。 请改用插入实体(V2)。

向表添加实体的作。

插入实体 (V2)

向表添加实体的作。

插入或合并实体 [已弃用]

此作已弃用。 请改用“插入”或“合并实体”(V2)。

将数据与表中的实体合并的作,根据需要创建新实体。

插入或合并实体 (V2)

将数据与表中的实体合并的作,根据需要创建新实体。

插入或替换实体 [已弃用]

此作已弃用。 请改用“插入”或“替换实体”(V2)。

替换表中的实体的作,如果需要,请创建新实体。

插入或替换实体 (V2)

替换表中的实体的作,如果需要,请创建新实体。

替换实体 [已弃用]

此作已弃用。 请改用替换实体(V2)。

替换表中实体的作。

替换实体 (V2)

替换表中实体的作。

获取实体 [已弃用]

此作已弃用。 请改用 Get 实体(V2)。

此作查询表中的实体。

获取实体 [已弃用]

此作已弃用。 请改用 Get 实体(V2)。

此作基于分区和行键获取表中的实体。

获取实体 (V2)

此作查询表中的实体。

获取实体 (V2)

此作基于分区和行键获取表中的实体。

获取表 [已弃用]

此作已弃用。 请改用“获取表”(V2)。

此作获取表的元数据。

获取表 (V2)

此作获取表的元数据。

列出表 [已弃用]

此作已弃用。 请改用 列表表(V2 )。

此作列出帐户中的表。

参数

名称 密钥 必需 类型 说明
客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

返回

表查询响应对象

列出表 (V2)

列出存储帐户的所有表。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

返回

表查询响应对象

创建表 [已弃用]

此作已弃用。 请改用“创建表”(V2)。

此作将表添加到存储帐户。

参数

名称 密钥 必需 类型 说明
Table
TableName True string

指定新表

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

返回

表的元数据

表元数据
getTableResponse

创建表 (V2)

此作将表添加到存储帐户。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
TableName True string

指定新表

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

返回

表的元数据

表元数据
getTableResponse

删除实体 [已弃用]

此作已弃用。 请改用“删除实体”(V2)。

删除实体的作。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

ETag
If-Match string

要匹配并发的 Etag。 * 以匹配所有值。

删除实体 (V2)

删除实体的作。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

ETag
If-Match string

要匹配并发的 Etag。 * 以匹配所有值。

删除表 [已弃用]

此作已弃用。 请改用“删除表”(V2)。

删除表。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

删除表 (V2)

删除表。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

合并实体 [已弃用]

此作已弃用。 请改用合并实体(V2)。

将数据与表中的实体合并的作。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

ETag
If-Match True string

要匹配并发的 Etag。 * 以匹配所有值。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

合并实体 (V2)

将数据与表中的实体合并的作。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

ETag
If-Match True string

要匹配并发的 Etag。 * 以匹配所有值。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

插入实体 [已弃用]

此作已弃用。 请改用插入实体(V2)。

向表添加实体的作。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

返回

单个实体的数据

插入实体 (V2)

向表添加实体的作。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

返回

单个实体的数据

插入或合并实体 [已弃用]

此作已弃用。 请改用“插入”或“合并实体”(V2)。

将数据与表中的实体合并的作,根据需要创建新实体。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

插入或合并实体 (V2)

将数据与表中的实体合并的作,根据需要创建新实体。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

插入或替换实体 [已弃用]

此作已弃用。 请改用“插入”或“替换实体”(V2)。

替换表中的实体的作,如果需要,请创建新实体。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

插入或替换实体 (V2)

替换表中的实体的作,如果需要,请创建新实体。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

替换实体 [已弃用]

此作已弃用。 请改用替换实体(V2)。

替换表中实体的作。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

ETag
If-Match True string

要匹配并发的 ETag。 * 以匹配所有值。

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

替换实体 (V2)

替换表中实体的作。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

ETag
If-Match True string

要匹配并发的 ETag。 * 以匹配所有值。

客户端请求 ID
x-ms-client-request-id string

客户端为作提供标识符,该标识符将在服务器响应中回显。

获取实体 [已弃用]

此作已弃用。 请改用 Get 实体(V2)。

此作查询表中的实体。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

筛选查询
$filter string

要返回的实体的 OData 筛选器查询。 示例:列 eq “Value” 和 Column2 ne 2。 无效的 OData 查询,例如不用引号包装字符串值将返回 501。

选择“查询”
$select string

OData 选择要返回的列的查询。 示例:Column、PartitionKey

返回

实体响应对象

获取实体结果
getEntitiesResponse

获取实体 [已弃用]

此作已弃用。 请改用 Get 实体(V2)。

此作基于分区和行键获取表中的实体。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

选择“查询”
$select string

OData 选择要返回的列的查询。 示例:Column、PartitionKey

返回

实体

获取实体 (V2)

此作查询表中的实体。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

筛选查询
$filter string

要返回的实体的 OData 筛选器查询。 示例:列 eq “Value” 和 Column2 ne 2。 无效的 OData 查询,例如不用引号包装字符串值将返回 501。

选择“查询”
$select string

OData 选择要返回的列的查询。 示例:Column、PartitionKey

返回

实体响应对象

获取实体结果
getEntitiesResponse

获取实体 (V2)

此作基于分区和行键获取表中的实体。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

分区键
PartitionKey True string

包含此实体的分区 ID

行键
RowKey True string

包含此实体的行 ID

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

选择“查询”
$select string

OData 选择要返回的列的查询。 示例:Column、PartitionKey

返回

实体

获取表 [已弃用]

此作已弃用。 请改用“获取表”(V2)。

此作获取表的元数据。

参数

名称 密钥 必需 类型 说明
Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

返回

表的元数据

表元数据
getTableResponse

获取表 (V2)

此作获取表的元数据。

参数

名称 密钥 必需 类型 说明
存储帐户名称或表终结点
storageAccountName True string

Azure 存储帐户名称或表终结点。

Table
tableName True string

指定表。

客户端请求 ID
x-ms-client-request-id string

用于跟踪请求的唯一标识符。

返回

表的元数据

表元数据
getTableResponse

定义

getTablesResponse

表查询响应对象

名称 路径 类型 说明
帐户元数据位置
odata.metadata string

帐户元数据的 URL

表列表
value array of object

表列表

表位置
value.odata.id string

表数据的 URL

表名称
value.TableName string

表名称

getTableResponse

表的元数据

名称 路径 类型 说明
表位置
odata.id string

表数据的 URL

表名称
TableName string

表名称

Item

实体

名称 路径 类型 说明
分区键
PartitionKey string

分区键

行键
RowKey string

行键

实体数据
additionalProperties string

实体的唯一列

getEntitiesResponse

实体响应对象

名称 路径 类型 说明
表元数据位置
odata.metadata string

表元数据位置

实体列表
value array of Item

实体列表

getEntityResponse

实体

名称 路径 类型 说明
表元数据位置
odata.metadata string

表元数据位置

分区键
PartitionKey string

分区键

行键
RowKey string

行键

实体数据
additionalProperties string

实体的唯一列

InsertEntityResponse

单个实体的数据

名称 路径 类型 说明
实体元数据位置
odata.metadata string

实体元数据位置

分区键
PartitionKey string

分区键

行键
RowKey string

行键

实体数据
additionalProperties string

实体的唯一列