使用 Google Cloud 控制台儲存健康照護資料

使用 Google Cloud 控制台儲存健康照護資料

本頁面說明如何使用 Cloud Healthcare API 和 Google Cloud 控制台 完成下列工作：

1. 建立 Cloud Healthcare API 資料集。
2. 在資料集中建立下列任一資料儲存庫：
• 數位醫學影像和通訊 (DICOM) 儲存庫
• 快速醫療照護互通資源 (FHIR) 儲存庫
• 健康狀態層級七 (國際版本 2) (HL7v2) 儲存庫
3. 儲存 DICOM 或 FHIR 資料，並查看 FHIR 資源內容。

如果您只想使用一種資料儲存庫，完成「事前準備」和「建立資料集」中的步驟後，可以直接跳到快速入門指南的相關章節。

---

如要直接在 Google Cloud 控制台按照逐步指南操作，請按一下「Guide me」(逐步引導)：

逐步引導

---

事前準備

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Enable the Cloud Healthcare API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

建立資料集

「資料集」包含資料儲存庫，以及含有醫療照護資料的資料儲存庫。 如要使用 Cloud Healthcare API，您至少須建立一個資料集。

1. 按一下 Google Cloud 控制台的「Healthcare」(醫療照護)，即可前往「Datasets」(資料集) 頁面。

   前往瀏覽器

2. 按一下「Create dataset」(建立資料集)。

3. 在「Name」(名稱) 欄位中輸入 my-dataset。

4. 選取「Region」(區域) 欄位中的「us-central1」，然後按一下「Create」(建立)。

新的資料集會出現在瀏覽器中的資料集清單內。

如要完成這項快速入門導覽課程，請選擇下列其中一個部分：

• 儲存 DICOM 執行個體
• 儲存及查看 FHIR 資源
• 儲存 HL7v2 訊息

儲存 DICOM 執行個體

本節說明如何完成下列工作：

1. 建立 DICOM 儲存庫。
2. 將 DICOM 執行個體匯入 DICOM 儲存庫。

Cloud Healthcare API 會導入 DICOMweb 標準，用於儲存及存取醫療影像資料。 Google Cloud 主控台不支援 DICOMweb 交易，例如檢視或擷取執行個體。

建立 DICOM 儲存庫

1. 前往 Google Cloud 控制台的 Cloud Healthcare API「Browser」(瀏覽器) 頁面：

   前往瀏覽器

1. 按一下「my-dataset」資料集。

2. 按一下「Create data store」(建立資料儲存庫)。

3. 在「Type」(類型) 選單中，選取「DICOM」。

4. 在「ID」欄位中，輸入 my-dicom-store。

5. 按一下「Create」(建立)。

DICOM 儲存庫「my-dicom-store」會顯示於「my-dataset」資料集的「Data stores」(資料儲存庫) 頁面中。

匯入 DICOM 執行個體

您可以在 Cloud Storage bucket「gs://gcs-public-data--healthcare-nih-chest-xray」中找到範例 DICOM 資料。

1. 在資料集的資料儲存庫清單中找到您建立的 DICOM 儲存庫，然後選取「Actions」(動作) 選單。

2. 選取「Import」(匯入)。

3. 選取「Import to DICOM store」(匯入 DICOM 儲存庫) 頁面中的「Advanced options」(進階選項) 選單，然後選取「Override Cloud Storage path」(覆寫 Cloud Storage 路徑)。

4. 在「Advanced options」(進階選項) 選單下方的「Location」(位置) 欄位中，輸入下列待匯入 DICOM 執行個體的位置：

   gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm
   

5. 按一下「Import」(匯入)。

6. 如要查看匯入狀態，請按一下「Operations」(作業) 分頁標籤。

   如果發生任何錯誤，請按一下「Actions」(動作)，然後點選「View details in Cloud Logging」(在 Cloud Logging 中查看詳細資料)。

您已在 Cloud Healthcare API 中儲存 DICOM 執行個體，請繼續參閱「後續步驟」一節，瞭解後續步驟，例如如何搜尋或擷取 DICOM 影像。

儲存及查看 FHIR 資源

本節說明如何完成下列工作：

1. 建立 FHIR 儲存庫。
2. 將 FHIR 資源匯入 FHIR 儲存庫。
3. 查看 FHIR 資源的資料。

Cloud Healthcare API 會導入 FHIR 規格，用於儲存及存取 FHIR 資料。 Google Cloud 主控台不支援特定 FHIR API 方法，例如建立或刪除 FHIR 資源，但您可以使用 FHIR 檢視器查看 FHIR 資源的內容。

建立 FHIR 儲存庫

1. 按一下「Browser」(瀏覽器) 來前往「Datasets」(資料集) 頁面。

2. 按一下「my-dataset」資料集。

3. 按一下「Create data store」(建立資料儲存庫)。

4. 在「Type」(類型) 選單中，選取「FHIR」。

5. 在「ID」欄位中，輸入 my-fhir-store。

6. 按「Next」(下一步)，藉此開啟「Configure your FHIR store」(設定 FHIR 儲存庫) 專區。

7. 按一下「R4」。

8. 按一下「Create」(建立)。

FHIR 儲存庫「my-fhir-store」會顯示於「my-dataset」資料集的「Data stores」(資料儲存庫) 頁面中。

匯入 FHIR 資源

您可以在 Cloud Storage bucket「gs://gcp-public-data--synthea-fhir-data-10-patients」中找到範例 FHIR 資料。這個 bucket 內有名為 fhir_r4_ndjson/ 的目錄，當中提供多種 FHIR 資源。

1. 在資料集內的資料儲存庫清單中，找出您建立的 FHIR 儲存庫「my-fhir-store」，然後選取「Actions」(動作) 選單。

2. 選取「Import」(匯入)。

3. 選取「Advanced options」(進階選項) 選單，然後選取「Override Cloud Storage path」(覆寫 Cloud Storage 路徑)。

4. 在「Advanced options」(進階選項) 選單下方的「Location」(位置) 欄位中，輸入下列待匯入 FHIR 資源的位置：

   gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/*.ndjson
   

5. 在「FHIR import settings」(FHIR 匯入設定) 專區中，選取「Resource」(資源)。

6. 按一下「Import」(匯入)。

7. 如要查看匯入狀態，請按一下「Operations」(作業) 分頁標籤。

   如果發生任何錯誤，請按一下「Actions」(動作)，然後點選「View details in Cloud Logging」(在 Cloud Logging 中查看詳細資料)。

查看 FHIR 資源內容

1. 前往 Google Cloud 控制台的「FHIR viewer」頁面。

   前往 FHIR 檢視器

1. 選取「FHIR store」(FHIR 儲存庫) 下拉式清單中的「my-dataset」資料集，然後選取 FHIR 儲存庫「my-fhir-store」。

2. 按一下「Resource Type」(資源類型) 欄位。在隨即出現的「Properties」(屬性) 下拉式清單中選取「Resource Type」(資源類型)，然後輸入「Patient」(病患)。

3. 在「Resource Type」(資源類型) 清單中，按一下「Patient」(病患)。

4. 選取其中一項病患資源。如要查看病患資源的詳細資訊，請按一下「Elements」(元素) 分頁標籤，或是點選「JSON」分頁標籤來查看 JSON 格式的病患資源詳細資料。

您已在 Cloud Healthcare API 中儲存及查看 FHIR 資源，請繼續參閱「後續步驟」一節，瞭解後續步驟。

儲存 HL7v2 訊息

本節說明如何完成下列工作：

1. 建立 HL7v2 儲存庫。
2. 將 HL7v2 訊息匯入 HL7v2 儲存庫。

建立 HL7v2 儲存庫

HL7v2 儲存庫位於資料集內，並含有 HL7v2 訊息。

1. 按一下「Browser」(瀏覽器) 來前往「Datasets」(資料集) 頁面。

2. 按一下「my-dataset」資料集。

3. 按一下「Create data store」(建立資料儲存庫)。

4. 在「Type」(類型) 選單中，選取「HL7v2」。

5. 在「ID」欄位中，輸入 my-hl7v2-store。

6. 按一下「Create」(建立)。

HL7v2 儲存庫「my-hl7v2-store」會顯示於「my-dataset」資料集的「Data stores」(資料儲存庫) 頁面中。

匯入 HL7v2 訊息

gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson 中提供 HL7v2 訊息示例。

1. 在資料集內的資料儲存庫清單中找到您建立的 HL7v2 儲存庫，然後選取「Actions」(動作) 選單。

2. 選取「Import」(匯入)。

3. 選取「Import to HL7v2 store」(匯入 HL7v2 儲存庫) 頁面中的「Advanced options」(進階選項) 選單，然後選取「Override Cloud Storage path」(覆寫 Cloud Storage 路徑)。

4. 在「Advanced options」(進階選項) 選單下方的「Location」(位置) 欄位中，輸入下列待匯入 HL7v2 訊息的位置：

   gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson
   

5. 按一下「Import」(匯入)。

6. 如要查看匯入狀態，請按一下「Operations」(作業) 分頁標籤。

   如果發生任何錯誤，請按一下「Actions」(動作)，然後點選「View details in Cloud Logging」(在 Cloud Logging 中查看詳細資料)。

建立 HL7v2 儲存庫後，請繼續參閱「後續步驟」一節，瞭解後續步驟，例如如何擷取及查看 HL7v2 訊息。

清除所用資源

如要避免系統向您的 Google Cloud 帳戶收取本頁所用資源的費用，請按照下列步驟操作。

如果不再需要這個快速入門導覽課程中建立的資料集和資料儲存庫，您可以刪除資料集。如果刪除資料集，該資料集以及其中包含的所有 FHIR、HL7v2 或 DICOM 儲存庫都會永久刪除。

如要刪除資料集，請完成下列步驟：

1. 按一下「Browser」(瀏覽器) 來前往「Datasets」(資料集) 頁面。
2. 按一下資料集旁的「Actions」(動作)，然後按一下「Delete」(刪除)。
3. 確認刪除資料集。

或者，您也可以刪除先前建立的專案。

後續步驟

您可以查看下列章節來取得 Cloud Healthcare API 的一般資訊，並瞭解如何使用 HTTP 要求和 Google Cloud CLI 來執行工作：

• 查看 Cloud Healthcare API 概念總覽。
• 搭配使用 Cloud Healthcare API 與 curl 或 PowerShell。
• 搭配使用 Cloud Healthcare API 與 gcloud CLI。

DICOM

繼續前往 DICOM 指南閱讀以下主題文章：

• 建立及管理 DICOM 儲存庫
• 將 PACS 連線至 Cloud Healthcare API
• 使用 DICOMweb 標準
• 使用 Cloud Storage 匯入及匯出 DICOM 資料

要瞭解 Cloud Healthcare API 如何導入 DICOMweb 標準，請參閱 DICOM 符合聲明。

FHIR

繼續前往 FHIR 指南閱讀以下主題文章：

• 建立及管理 FHIR 儲存庫
• 建立及管理 FHIR 資源
• 使用 Cloud Storage 匯入及匯出 FHIR 資料

要瞭解 Cloud Healthcare API 如何導入 FHIR 標準，請參閱 FHIR 符合聲明。

HL7v2

繼續前往 HL7v2 指南閱讀以下主題文章：

• 建立及管理 HL7v2 儲存庫
• 建立及管理 HL7v2 訊息
• 透過 TCP/IP 連線傳送 HL7v2 訊息
• 使用 Cloud Storage 匯入及匯出 HL7v2 訊息