本頁說明如何建立、編輯、查看、列出及刪除資料集。建立資料集後,您可以建立資料儲存庫來保存電子病歷和醫學影像資料、去識別化資料集等。
事前準備
請參閱 Cloud Healthcare API 的資料模型。
建立資料集
下列範例說明如何建立資料集。
控制台
前往 Google Cloud 控制台的「Browser」頁面。
按一下「建立資料集」add_box。系統隨即會顯示「資料集屬性」頁面。
在「名稱」欄位中,輸入資料集識別碼,並遵守資料集允許的字元和大小限制。
選取下列其中一種地點類型:
區域。資料集會永久保留在一個 Google Cloud 區域中。 選取這個選項後,請在「區域」欄位中輸入或選取位置。
多區域。資料集會永久存放在跨越多個 Google Cloud 區域的位置。選取這個選項後,請在「多區域」欄位中輸入或選取多區域位置。
點選「建立」。系統隨即會顯示「瀏覽器」頁面。新的資料集會顯示在資料集清單中。
gcloud
執行 gcloud healthcare datasets create 指令。
使用下方的任何指令資料之前,請先替換以下項目:
LOCATION:資料集的支援位置DATASET_ID: 符合資料集允許的字元和大小限制的 ID
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud healthcare datasets create DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets create DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets create DATASET_ID ^ --location=LOCATION
您應該會收到類似以下的回應:
Create request issued for: [DATASET_ID] Created dataset [DATASET_ID].
REST
使用
projects.locations.datasets.create方法建立資料集。使用任何要求資料之前,請先修改下列項目的值:
PROJECT_ID:您 Google Cloud 專案的 IDLOCATION:資料集的支援位置DATASET_ID: 符合資料集允許的字元和大小限制的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下所示。回覆會包含長時間執行的作業 (LRO) 的 ID。如果方法呼叫可能需要額外時間才能完成,系統就會傳回長時間執行的作業。請記下curl
執行下列指令:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。系統會在頁面右側開啟 APIs Explorer 面板。您可以使用這項工具來傳送要求。完成任何必填欄位,然後按一下「執行」。
OPERATION_ID的值。下一個步驟會用到這個值。使用
projects.locations.datasets.operations.get方法取得長時間執行的作業狀態。使用任何要求資料之前,請先修改下列項目的值:
PROJECT_ID:您 Google Cloud 專案的 IDLOCATION:資料集位置DATASET_ID:資料集 IDOPERATION_ID:長時間執行的作業傳回的 ID
如要傳送要求,請選擇以下其中一個選項:
輸出內容如下所示。如果回應包含curl
執行下列指令:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
執行下列指令:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
開啟方法參考頁面。系統會在頁面右側開啟 APIs Explorer 面板。您可以使用這項工具來傳送要求。完成任何必填欄位,然後按一下「執行」。
"done": true,表示長時間執行的作業已完成。