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

教程:执行 CSV 分析程序引入

逗号分隔值 (CSV) 分析程序引入提供了将 CSV 文件引入 Azure Data Manager for Energy 实例的功能。

本教程介绍如何执行下列操作:

  • 使用 Postman 将示例井口数据 CSV 文件引入 Azure Data Manager for Energy 实例。
  • 使用 Postman 搜索 CSV 引入期间创建的存储元数据记录。

先决条件

开始本教程之前,需具备以下先决条件。

获取 Azure Data Manager for Energy 实例的详细信息

  • 需要 Azure Data Manager for Energy 实例。 如果还没有,请按照快速入门:创建 Azure Data Manager for Energy 实例中的步骤创建一个。

  • 若要完成本教程,需要以下参数:

    参数 要使用的值 示例 本值的所在位置
    CLIENT_ID 应用程序(客户端)ID 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx 将应用程序注册到 Microsoft 标识平台时,请使用此应用 ID 或 client_ID。 请参阅注册应用程序
    CLIENT_SECRET 客户端机密 _fl****************** 客户端机密有时称为应用程序密码,它是一个字符串值,应用可以使用该值代替证书来标识自身。 请参阅添加客户端密码
    TENANT_ID 目录(租户)ID 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx 将鼠标指针悬停在 Azure 门户中的帐户名上来获取目录或租户 ID。 或者,在 Azure 门户中搜索并选择“Microsoft Entra ID”>“属性”>“租户 ID”。
    SCOPE 应用程序(客户端)ID 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx 此值与前面提到的应用或客户端 ID 相同。
    refresh_token 刷新令牌值 0.ATcA01-XWHdJ0ES-qDevC6r........... 按照如何生成刷新令牌创建并保存刷新令牌。 稍后需要此刷新令牌来生成用户令牌。
    DNS URI <instance>.energy.Azure.com 在 Azure Data Manager for Energy 实例的概述页找到此值。
    data-partition-id 数据分区 <instance>-<data-partition-name> 在 Azure Data Manager for Energy 实例的概述页找到此值。

按照管理用户指南为运行本教程的用户添加相应的权利。

设置 Postman 并执行请求

  1. 下载并安装 Postman 桌面应用。

  2. 将以下文件导入 Postman:

    若要导入 Postman 集合和环境变量,请按照将数据导入 Postman 中的步骤操作。

  3. 使用从 Azure Data Manager for Energy 实例详细信息中获取的信息来更新 Postman 环境的 CURRENT_VALUE

  4. CSV 分析程序引入的 Postman 集合包含必须按顺序执行的 10 个请求。

    在触发 Postman 集合之前,请务必选择“引入工作流环境”

    Screenshot of the Postman environment.

  5. 通过选择“发送”按钮来触发每个请求。

    每次请求时,Postman 都会根据预期的响应代码来验证实际的 API 响应代码。 如果有任何不匹配,测试部分将指示失败。

下面是成功 Postman 请求的示例:

Screenshot of a successful Postman call.

下面是失败 Postman 请求的示例:

Screenshot of a failed Postman call.

使用 Postman 引入井口数据

若要使用 Postman 集合将示例井口数据 CSV 文件引入 Azure Data Manager for Energy 实例,请完成以下步骤:

  1. 获取用户访问令牌:生成用户令牌,用于对进一步的 API 调用进行身份验证。

  2. 创建架构:生成符合 CSV 文件中存在的列的架构。

  3. 获取架构详细信息:获取并验证在上一步中创建的架构。

  4. 创建法律标记:创建一个法律标记,将其添加到 CSV 数据以实现数据合规性目的。

  5. 获取用于上传 CSV 文件的签名 URL:获取要上传 CSV 文件的签名 URL 路径。

  6. 上传 CSV 文件:将 Wellbore.csv 示例下载到本地计算机,并在 Postman 中单击“选择文件”按钮选择此文件。

    Screenshot of uploading a CSV file.

  7. 上传 CSV 文件元数据:上传文件元数据信息,例如文件位置以及其他相关字段。

  8. 创建 CSV 分析器引入工作流:为 CSV 分析器引入工作流创建有向无环图 (DAG)。

  9. 触发 CSV 分析程序引入工作流:触发 CSV 分析程序引入工作流 DAG。

  10. 搜索引入的 CSV 分析程序工作流状态:获取 CSV 分析程序 DAG 运行的状态。

使用 Postman 搜索引入的井口数据

若要使用 Postman 集合搜索 CSV 引入期间创建的存储元数据记录,请完成以下步骤:

  • 搜索引入的 CSV 记录:搜索前面创建的 CSV 记录。

    Screenshot of searching ingested CSV records.

下一步

转到下一教程: