Lakehouse 定义

本文提供使用 LakehouseDefinitionV1 格式的 Lakehouse 项的定义结构细目。 有关详细信息，请参阅： 如何使用 Microsoft Fabric Rest API 创建 lakehouse

支持的格式

Lakehouse 项支持格式 LakehouseDefinitionV1 。 如果未指定任何格式，则默认为 LakehouseDefinitionV1。

定义部件

LakehouseMetadata

描述 Lakehouse 元数据。

Shortcut

目标

一个包含目标数据源的对象，必须指定一个受支持的目标，如下表所述。

类型（枚举）

类型对象包含目标快捷方式帐户类型等属性。 可能会随着时间的推移添加其他类型。

OneLake

包含目标 OneLake 数据源的属性的对象。

AdlsGen2

包含目标 ADLS Gen2 数据源的属性的对象。

AmazonS3

包含目标 Amazon S3 数据源的属性的对象。

Dataverse

包含目标 Dataverse 数据源的属性的对象。

S3Compatible

包含目标 S3 兼容数据源的属性的对象。

DataAccessRole

DecisionRule

指定与请求的作匹配的规则。 包含效果（允许）和权限，用于确定用户或实体是否有权对资源执行特定作。

权限范围

定义一组属性，用于确定对资源的访问权限的范围和级别。

限制条件

作为此角色的一部分应用于表的任何约束，例如行级或列级安全性。

ColumnConstraint

指示一个约束，该约束确定用户对表中的列的权限和可见性。

RowConstraint

指示一个约束，该约束确定用户可以查看的表中的行。 使用 RowConstraints 定义的角色使用 T-SQL 来定义筛选表中数据的谓词。

Members

成员对象，该对象包含角色的成员作为不同成员类型的数组。

除了 FabricItemMembers，Onelake 安全性还支持添加 MicrosoftEntraMembers 列表。 在 lakehouse 项定义 API 和 Lakehouse CICD 中不受支持，如果指定，将忽略它。

FabricItemMember

枚举

属性名称

ColumnAction

ColumnEffect

影响

ALMSettings

介绍 Lakehouse 部署管道和 git作的对象类型设置。 这可用于启用或禁用对象类型的 git 集成。

对象类型

可跟踪 ALM作的对象类型。

SubObjectType

可跟踪 ALM作的子对象类型。 支持 Shortcuts 对象类型。

LakehouseMetadata 示例

{
  "defaultSchema": "dbo"
}

快捷方式示例

[
  {
      "name": "TestShortcut",
      "path": "/Tables/dbo",
      "target": {
        "type": "OneLake",
        "oneLake": {
          "path": "Tables/dbo/publicholidays",
          "itemId": "00000000-0000-0000-0000-000000000000",
          "workspaceId": "00000000-0000-0000-0000-000000000000"
      }
    }
  }
]

DataAccessRoles 示例

[
    {
        "name": "dimensionrulerename",
        "kind": "Policy",
        "decisionRules": [
          {
            "effect": "Permit",
            "permission": [
              {
                "attributeName": "Path",
                "attributeValueIncludedIn": [
                  "/Tables/dbo/dimension_city",
                  "/Tables/dbo/dimension_customer",
                  "/Tables/dbo/dimension_date",
                  "/Tables/dbo/dimension_employee",
                  "/Tables/dbo/dimension_stock_item",
                  "/Tables/bronze"
                ]
              },
              {
                "attributeName": "Action",
                "attributeValueIncludedIn": [
                  "Read"
                ]
              }
            ],
            "constraints": {}
          }
        ],
        "members": {
          "fabricItemMembers": [],
            "microsoftEntraMembers": [
            {
              "tenantId": "1e85000e-ee35-4112-bd46-2f00b3d94154",
              "objectId": "5f3efd37-a6d2-432f-99fa-6adc2848a40a"
            }
          ]
        }
      },
      {
        "name": "DefaultReader",
        "kind": "Policy",
        "decisionRules": [
          {
            "effect": "Permit",
            "permission": [
              {
                "attributeName": "Action",
                "attributeValueIncludedIn": [
                  "Read"
                ]
              },
              {
                "attributeName": "Path",
                "attributeValueIncludedIn": [
                  "*"
                ]
              }
            ]
          }
        ],
        "members": {
          "fabricItemMembers": [
            {
              "itemAccess": [
                "ReadAll"
              ],
              "sourcePath": "00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000000"
            }
          ]
        }
      }
    ]

ALMSettings 示例

{
  "version": "1.0.1",
  "objectTypes": [
    {
      "name": "Shortcuts",
      "state": "Enabled",
      "subObjectTypes": [
        {
          "name": "Shortcuts.OneLake",
          "state": "Enabled"
        },
        {
          "name": "Shortcuts.AdlsGen2",
          "state": "Enabled"
        },
        {
          "name": "Shortcuts.Dataverse",
          "state": "Enabled"
        },
        {
          "name": "Shortcuts.AmazonS3",
          "state": "Enabled"
        },
        {
          "name": "Shortcuts.S3Compatible",
          "state": "Enabled"
        },
        {
          "name": "Shortcuts.GoogleCloudStorage",
          "state": "Enabled"
        }
      ]
    },
    {
      "name": "DataAccessRoles",
      "state": "Enabled"
    }
  ]
}