このページでは、データセットを作成、編集、表示、一覧表示、削除する方法について説明します。データセットを作成したら、電子医療記録や医用画像データを保持するデータストアを作成したり、データセットの匿名化を行ったりできます。
準備
Cloud Healthcare API のデータモデルをご覧ください。
データセットの作成
以下のサンプルは、データセットの作成方法を示しています。
Console
Google Cloud コンソールの [ブラウザ] ページに移動します。
[add_boxデータセットを作成] をクリックします。[データセットのプロパティ] ページが表示されます。
[名前] フィールドに、データセットで許可される文字とサイズの要件に従って、データセットの ID を入力します。
次のいずれかのロケーション タイプを選択します。
Region を使用します。リージョン: データセットは、1 つの Google Cloud リージョン内に永続的に存在します。このオプションを選択したら、[リージョン] フィールドにロケーションを入力するか選択します。
マルチリージョンデータセットは、複数の Google Cloud リージョンにまたがるロケーションに永続的に存在します。このオプションを選択したら、[マルチリージョン] フィールドにマルチリージョン ロケーションを入力または選択します。
[作成] をクリックします。[Browser] ページが表示されます。新しいデータセットがデータセットのリストに表示されます。
gcloud
gcloud healthcare datasets create
コマンドを実行します。
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットのサポートされているロケーションDATASET_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
: データセットに使用可能な文字とサイズの要件の対象となる識別子
リクエストを送信するには、次のいずれかのオプションを選択します。
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 ContentAPI Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
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 ContentAPI Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
"done": true
が含まれている場合、長時間実行オペレーションは終了しています。
Go
Java
Node.js
Python
データセットの編集
次のサンプルは、データセットを編集する方法を示しています。
Console
Google Cloud コンソールでは、データセットの編集はサポートされていません。代わりに、Google Cloud CLI または REST API を使用してください。
gcloud
gcloud healthcare datasets update
コマンドを実行します。
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所DATASET_ID
: データセット IDTIME_ZONE
: サポートされているタイムゾーン(UTC
など)
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare datasets update DATASET_ID \ --location=LOCATION \ --time-zone=TIME_ZONE
Windows(PowerShell)
gcloud healthcare datasets update DATASET_ID ` --location=LOCATION ` --time-zone=TIME_ZONE
Windows(cmd.exe)
gcloud healthcare datasets update DATASET_ID ^ --location=LOCATION ^ --time-zone=TIME_ZONE
次のようなレスポンスが返されます。
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
projects.locations.datasets.patch
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: データセット IDTIME_ZONE
: サポートされているタイムゾーン(UTC
など)
リクエストの本文(JSON):
{ "timeZone": "TIME_ZONE" }
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone"
PowerShell
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone" | Select-Object -Expand Content
API Explorer
リクエスト本文をコピーして、メソッドのリファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。このツールにリクエスト本文を貼り付け、その他の必須フィールドに入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
Go
Java
Node.js
Python
データセットの詳細の取得
以下のサンプルは、データセットの詳細を取得する方法を示しています。
Console
Google Cloud コンソールの [ブラウザ] ページに移動します。
データセットを選択します。[データセット] ページとデータセット内のデータストアが表示されます。
gcloud
gcloud healthcare datasets describe
コマンドを実行する
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所DATASET_ID
: データセット ID
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare datasets describe DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare datasets describe DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare datasets describe DATASET_ID ^ --location=LOCATION
次のようなレスポンスが返されます。
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
projects.locations.datasets.get
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_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"
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" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
Go
Java
Node.js
Python
データセットのリスト表示
以下のサンプルは、プロジェクト内のデータセットを一覧表示する方法を示しています。
Console
Google Cloud コンソールの [ブラウザ] ページに移動します。
gcloud
gcloud healthcare datasets list
コマンドを実行する
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare datasets list --location=LOCATION
Windows(PowerShell)
gcloud healthcare datasets list --location=LOCATION
Windows(cmd.exe)
gcloud healthcare datasets list --location=LOCATION
次のようなレスポンスが返されます。
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
projects.locations.datasets.list
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
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" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
次のような JSON レスポンスが返されます。
Go
Java
Node.js
Python
データセットの削除
以下のサンプルは、データセットの削除方法を示しています。
Console
Google Cloud コンソールの [ブラウザ] ページに移動します。
データセットと同じ行で、
[アクション] オプションをクリックし、[削除] を選択します。確認ダイアログでデータセット ID を入力し、[削除] をクリックします。
gcloud
gcloud healthcare datasets delete
コマンドを実行する
後述のコマンドデータを使用する前に、次のように置き換えます。
LOCATION
: データセットの場所DATASET_ID
: データセット ID
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud healthcare datasets delete DATASET_ID \ --location=LOCATION
Windows(PowerShell)
gcloud healthcare datasets delete DATASET_ID ` --location=LOCATION
Windows(cmd.exe)
gcloud healthcare datasets delete DATASET_ID ^ --location=LOCATION
確認するには、「Y」と入力します。
次のような出力が表示されます。
Deleted dataset [DATASET_ID]
REST
projects.locations.datasets.delete
メソッドを使用します。
リクエストのデータを使用する前に、次のように置き換えます。
PROJECT_ID
: Google Cloud プロジェクトの IDLOCATION
: データセットの場所DATASET_ID
: データセット ID
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
次のコマンドを実行します。
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
次のコマンドを実行します。
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content
API Explorer
メソッド リファレンス ページを開きます。ページの右側に [API Explorer] パネルが開きます。このツールを操作してリクエストを送信できます。必須フィールドを入力して、[Execute] をクリックします。
成功したことを示すステータス コード(2xx)と空のレスポンスが返されます。