Share via

教學課程：執行基於資訊清單的檔案擷取

  • 發行項

資訊清單擷取提供了將資訊清單擷取到用於能源產業的 Azure 資料管理員執行個體的功能。

在本教學課程中，您會了解如何：

  • 使用 Postman 將範例資訊清單擷取到用於能源產業的 Azure 資料管理員執行個體中。
  • 使用 Postman 搜尋在資訊清單擷取期間所建立的儲存中繼資料記錄。

必要條件

在開始本教學課程之前，請完成下列先決條件。

取得用於能源產業的 Azure 資料管理員執行個體的詳細資料

  • 您需要一個用於能源產業的 Azure 資料管理員執行個體。 如果您還沒有，請按照「快速入門：建立用於能源產業的 Azure 資料管理員執行個體」中的步驟建立一個。

  • 對於本教學課程，您需要下列參數：

    參數 要使用的值 範例 哪裡可以找到此值
    CLIENT_ID 應用程式 (用戶端) 識別碼 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx 在 Microsoft 身分識別平台上註冊應用程式時，您使用了此應用程式或用戶端識別碼。 請參閱註冊應用程式。
    CLIENT_SECRET 用戶端密碼 _fl****************** 用戶端密碼 (有時稱為「應用程式密碼」) 是一個您的應用程式可以用來取代憑證識別自己的字串值。 請參閱新增用戶端密碼。
    TENANT_ID 目錄 (租用戶) 識別碼 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx 在 Azure 入口網站中將滑鼠的游標懸停在您的帳戶名稱上，以取得目錄或租用戶識別碼。 或者，在 Azure 入口網站中搜尋並選取 [Microsoft Entra ID]>[屬性]>[租用戶識別碼]。
    SCOPE 應用程式 (用戶端) 識別碼 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx 此值與前面提到的應用程式或用戶端識別碼相同。
    refresh_token 重新整理權杖值 0.ATcA01-XWHdJ0ES-qDevC6r........... 請遵循「如何產生驗證權杖」來建立重新整理權杖並加以儲存。 稍後您需要此重新整理權杖來產生使用者權杖。
    DNS URI <instance>.energy.Azure.com 在用於能源產業的 Azure 資料管理員執行個體的概觀頁面上尋找此值。
    data-partition-id 資料磁碟分割 <instance>-<data-partition-name> 在用於能源產業的 Azure 資料管理員執行個體的概觀頁面上尋找此值。

請遵循管理使用者指南，為執行本教學課程的使用者新增適當的權利。

設定 Postman 並執行要求

  1. 下載並安裝 Postman 桌面應用程式。

  2. 將下列檔案匯入 Postman：

    若要匯入 Postman 集合和環境變數，請遵循「將資料匯入 Postman」中的步驟。

  3. 使用您在用於能源產業的 Azure 資料管理員執行個體詳細資料中取得的資訊，更新 Postman 環境的目前值 (CURRENT VALUE)。

  4. 用於資訊清單擷取的 Postman 集合包含多個您必須依序執行的要求。

    在觸發 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 集合將資訊清單擷取到用於能源產業的 Azure 資料管理員執行個體中，請完成下列步驟：

  1. 取得使用者存取權杖：產生使用者權杖，該權杖將用來驗證進一步的 API 呼叫。

  2. 建立合法標籤：建立一個合法標籤，該標籤將新增到資訊清單資料中以符合資料合規性目的。

  3. 取得用於上傳檔案的已簽署 URL：取得將上傳資訊清單檔到其中的已簽署 URL 路徑。

  4. 上傳檔案：將 Wellbore.csv 範例下載到本機電腦。 其可以是任何檔案類型，包括 CSV、LAS 或 JSON。 按一下 [選取檔案] 按鈕，在 Postman 中選取此檔案。

    Screenshot of uploading a manifest file.

  5. 上傳檔案中繼資料：上傳檔案中繼資料資訊，例如檔案位置和其他相關欄位。

  6. 取得檔案中繼資料：呼叫以驗證中繼資料是否已成功建立。

  7. 擷取主圖形、參考和工作產品元件 (WPC) 資料：內嵌主要、參考和工作產品元件 (WPC) 資訊清單中繼資料。

  8. 取得資訊清單擷取工作流程狀態：工作流程會啟動且處於執行中狀態。 請繼續查詢，直到狀態變更為完成為止 (通常是 20 到 30 秒)。

使用 Postman 搜尋內嵌的資料

若要使用 Postman 集合搜尋在資訊清單擷取期間所建立的儲存中繼資料記錄，請完成下列步驟：

  1. 搜尋工作產品：呼叫搜尋服務以擷取工作產品中繼資料記錄。
  2. 搜尋工作產品元件：呼叫搜尋服務以擷取 WPC 中繼資料記錄。
  3. 搜尋資料集：呼叫搜尋服務以擷取資料集中繼資料記錄。
  4. 搜尋主要資料：呼叫搜尋服務以擷取主要中繼資料記錄。
  5. 搜尋參考資料：呼叫搜尋服務以擷取參考中繼資料記錄。

後續步驟

前進到下一個教學課程：

教學課程：使用 sdutil 將資料載入 Seismic 存放區

如需資訊清單擷取的詳細資訊，請參閱 OSDU 操作員資料載入快速入門指南。