你当前正在访问 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	00001111-aaaa-2222-bbbb-3333cccc4444	将应用程序注册到 Microsoft 标识平台时，请使用此应用 ID 或 client_ID。 请参阅注册应用程序。
  CLIENT_SECRET	客户端机密	_fl******************	客户端机密有时称为应用程序密码，它是一个字符串值，应用可以使用该值代替证书来标识自身。 请参阅添加客户端密码。
  TENANT_ID	目录（租户）ID	72f988bf-86f1-41af-91ab-xxxxxxxxxxxx	将鼠标指针悬停在 Azure 门户中的帐户名上来获取目录或租户 ID。 或者，在 Azure 门户中搜索并选择“Microsoft Entra ID”>“属性”>“租户 ID”。
  SCOPE	应用程序（客户端）ID	00001111-aaaa-2222-bbbb-3333cccc4444	此值与前面提到的应用或客户端 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：

   • CSV 工作流 Postman 集合
   • CSV 工作流 Postman 环境

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

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

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

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

   

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

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

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

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

使用 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 中单击“选择文件”按钮选择此文件。

   

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

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

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

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

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

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

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

  

下一步

转到下一教程：

教程：执行基于清单的文件引入