通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

infer_storage_schema_with_suggestions plugin

  • 项目

适用于：✅Microsoft Fabric✅Azure 数据资源管理器

此 infer_storage_schema_with_suggestions 插件可以推断外部数据的架构并返回 JSON 对象。 对于每个列，该对象提供推断出的类型、建议的类型和建议的映射转换。 建议的类型和映射由建议逻辑提供，该逻辑使用以下逻辑确定最佳类型：

  • 标识列：如果列的推断类型为 long，且列名以 id 结尾，则建议的类型为 string，因为它为包含通用相等性筛选器的标识列提供优化的索引。
  • Unix 日期/时间列：如果列的推断类型为 long，并且其中一个 Unix 时间到日期/时间的映射转换生成了有效的日期/时间值，则建议的类型为 datetime，而建议的 ApplicableTransformationMapping 映射则是生成有效日期/时间值的映射。

该插件通过 evaluate 运算符调用。 要获取使用创建和更改 Azure Storage 外部表的推断架构的表架构，而不使用建议，请使用 infer_storage_schema 插件。

身份验证和授权

在请求的属性中，指定要访问的存储连接字符串。 每个存储连接字符串都指定用于访问存储的授权方法。 根据授权方法，可能需要向主体授予对外部存储的权限才能执行架构推理。

下表按存储类型列出了支持的身份验证方法和任何所需的权限。

身份验证方法 Azure Blob 存储/Data Lake Storage Gen2 Data Lake Storage Gen1
模拟 存储 Blob 数据读取者 读取器
共享访问 (SAS) 令牌 列出 + 读取 Gen1 不支持此身份验证方法。
Microsoft Entra 访问令牌
存储帐户访问密钥 Gen1 不支持此身份验证方法。

语法

evaluate infer_storage_schema_with_suggestions( 选项 )

详细了解语法约定。

参数

客户 类型​​ 必需 说明
选项 dynamic ✔️ 一个用于指定请求属性的属性包。

请求的受支持的属性

名称 类型​​ 必需 说明
StorageContainers dynamic ✔️ 存储连接字符串的数组，这些字符串表示存储的数据项目的前缀 URI。
DataFormat string ✔️ 支持的支持摄取的数据格式之一
FileExtension string 如果指定，则函数仅扫描以此文件扩展名结尾的文件。 指定扩展名可以加快进程或避免数据读取问题。
FileNamePrefix string 如果指定，则函数仅扫描以此前缀开头的文件。 指定前缀可以加快进程。
模式 string 架构推理策略。 值：any、last、all。 此函数分别从找到的第一个文件、最后写入的文件或者从所有文件来推断数据架构。 默认值为 last。
InferenceOptions dynamic 更多推理选项。 有效选项：UseFirstRowAsHeader（对于带分隔符的文件格式）。 例如，'InferenceOptions': {'UseFirstRowAsHeader': true}。

返回

infer_storage_schema_with_suggestions 插件返回一个结果表，其中包含一个保留了 JSON 字符串的行/列。

注意

  • 除了“读取”的权限外，存储容器 URI 密钥还必须具有“列表”的权限 。
  • 架构推理策略“all”是非常“昂贵”的运算，因为它意味着要从所有找到的项目中读取并合并它们的架构。
  • 由于错误的类型推测（或者由于架构合并进程），有些返回的类型可能并不是实际的类型。 正因如此，你应在使用它们之前仔细检查结果。

示例

let options = dynamic({
  'StorageContainers': [
    h@'https://storageaccount.blob.core.windows.net/MobileEvents;secretKey'
  ],
  'FileExtension': '.json',
  'FileNamePrefix': 'js-',
  'DataFormat': 'json'
});
evaluate infer_storage_schema_with_suggestions(options)

示例输入数据

    {
        "source": "DataExplorer",
        "created_at": "2022-04-10 15:47:57",
        "author_id": 739144091473215488,
        "time_millisec":1547083647000
    }

输出

{
  "Columns": [
    {
      "OriginalColumn": {
        "Name": "source",
        "CslType": {
          "type": "string",
          "IsNumeric": false,
          "IsSummable": false
        }
      },
      "RecommendedColumn": {
        "Name": "source",
        "CslType": {
          "type": "string",
          "IsNumeric": false,
          "IsSummable": false
        }
      },
      "ApplicableTransformationMapping": "None"
    },
    {
      "OriginalColumn": {
        "Name": "created_at",
        "CslType": {
          "type": "datetime",
          "IsNumeric": false,
          "IsSummable": true
        }
      },
      "RecommendedColumn": {
        "Name": "created_at",
        "CslType": {
          "type": "datetime",
          "IsNumeric": false,
          "IsSummable": true
        }
      },
      "ApplicableTransformationMapping": "None"
    },
    {
      "OriginalColumn": {
        "Name": "author_id",
        "CslType": {
          "type": "long",
          "IsNumeric": true,
          "IsSummable": true
        }
      },
      "RecommendedColumn": {
        "Name": "author_id",
        "CslType": {
          "type": "string",
          "IsNumeric": false,
          "IsSummable": false
        }
      },
      "ApplicableTransformationMapping": "None"
    },
    {
      "OriginalColumn": {
        "Name": "time_millisec",
        "CslType": {
          "type": "long",
          "IsNumeric": true,
          "IsSummable": true
        }
      },
      "RecommendedColumn": {
        "Name": "time_millisec",
        "CslType": {
          "type": "datetime",
          "IsNumeric": false,
          "IsSummable": true
        }
      },
      "ApplicableTransformationMapping": "DateTimeFromUnixMilliseconds"
    }
  ]
}

相关内容