本页面介绍如何创建、修改、查看、列出和删除数据集。在使用本页面之前,请先熟悉 Cloud Healthcare API 数据模型。
创建数据集
创建数据集是使用 Cloud Healthcare API 中的大多数功能的第一步。创建数据集后,您可以创建用于存储电子健康记录、医学影像数据、用户许可等的数据存储区。
以下示例展示了如何创建数据集。
控制台
- 在 Google Cloud Console 中,转到数据集页面。
- 点击创建数据集。
-
在名称字段中,输入数据集的标识符。数据集 ID 必须符合以下条件:
- 位置中的唯一 ID
- 由 1-256 个字符组成的 Unicode 字符串,由以下各项组成:
- 数字
- 字母
- 下划线
- 短划线
- 英文句点
-
在位置类型部分,选择以下任一位置类型:
- 区域:数据集永久位于一个 Google Cloud 区域内。选择完毕后,在区域字段中输入或选择位置。
- 多区域:数据集永久位于跨越多个 Google Cloud 区域的单个位置。选择后,在多区域字段中输入或选择多区域位置。
新数据集将显示在数据集列表中。
gcloud
要创建数据集,请运行 gcloud healthcare datasets create
命令:
- DATASET_ID 在该区域内必须是唯一的。它可以是 1 到 256 个字符的任意 Unicode 字符串,由数字、字母、下划线、短划线和句点组成。
- 区域可以是
us-central1
、us-west1
、us-west2
、us-west3
、us-east1
、us-east4
、europe-west2
、europe-west3
、europe-west4
、europe-west6
、northamerica-northeast1
、southamerica-east1
、asia-east2
、asia-northeast1
、asia-northeast3
、asia-south1
、asia-southeast1
、australia-southeast1
或us
。如需使用项目的默认区域,请省略--location
选项。
gcloud healthcare datasets create DATASET_ID \ --location=LOCATION
命令行会显示操作 ID,并在操作完成后确认创建了数据集:
Create request issued for: [DATASET_ID] Waiting for operation [projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID] to complete...done. Created dataset [DATASET_ID].
要查看操作的更多详情,请运行 gcloud healthcare operations describe
命令,并提供响应中的 OPERATION_ID:
gcloud healthcare operations describe OPERATION_ID \ --dataset=DATASET_ID
响应包括 done: true
:
done: true metadata: '@type': type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata apiMethodName: google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset createTime: 'CREATE_TIME' endTime: 'END_TIME' name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID response: '@type': type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID
REST 和命令行
创建数据集。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目的 ID
- LOCATION:数据集的位置。使用
us-central1
、us-west1
、us-west2
、us-west3
、us-east1
、us-east4
、europe-west2
、europe-west3
、europe-west4
、europe-west6
、northamerica-northeast1
、southamerica-east1
、asia-east2
、asia-northeast1
、asia-northeast3
、asia-south1
、asia-southeast1
、australia-southeast1
或us
。 - DATASET_ID:数据集的标识符。数据集 ID 必须符合以下条件:
- 位置中的唯一 ID
- 包含 1-256 个字符的 Unicode 字符串,由以下各项组成:
- 数字
- 字母
- 下划线
- 短划线
- 英文句点
如需发送请求,请选择以下方式之一:
curl
执行以下命令:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default 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 application-default 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 面板会在页面右侧打开。您可以与此工具进行互动以发送请求。填写所有必填字段,然后点击执行。
获取长时间运行的操作的状态。
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目的 ID
- LOCATION:数据集位置
- DATASET_ID:要创建的数据集 ID
- OPERATION_ID:长时间运行的操作的 ID
如需发送请求,请选择以下方式之一:
curl
执行以下命令:
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。API Explorer 面板会在页面右侧打开。您可以与此工具进行互动以发送请求。填写所有必填字段,然后点击执行。
"done": true
,表示已成功创建数据集。
Go
Java
Node.js
Python
编辑数据集
以下示例展示了如何修改现有数据集。
控制台
Google Cloud Console 不支持修改医疗保健数据集。请改用 curl
、Windows PowerShell 或您的首选语言。
gcloud
要修改数据集,请运行 gcloud healthcare datasets update
命令并指定新时区。例如,您可以将时区设置为“加拿大/东部地区”。
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 和命令行
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目的 ID
- LOCATION:数据集位置
- DATASET_ID:数据集 ID
- TIME_ZONE:支持的时区,例如
UTC
请求 JSON 正文:
{ "timeZone": "TIME_ZONE" }
如需发送请求,请选择以下方式之一:
curl
- 将请求正文保存在名为
request.json
的文件中。复制以下命令,并在终端中运行它以创建此文件。cat > request.json << 'EOF' { "timeZone": "TIME_ZONE" } EOF
- 在终端运行以下命令。它引用您刚刚创建的
request.json
文件。curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth application-default 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
的文件中。复制以下命令,并在终端中运行它以创建此文件。@' { "timeZone": "TIME_ZONE" } '@ | Out-File -FilePath request.json -Encoding utf8
- 在终端运行以下命令。它引用您刚刚创建的
request.json
文件。$cred = gcloud auth application-default 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 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。将请求正文粘贴到此工具中,填写任何其他必填字段,然后点击执行。
您应该收到类似以下内容的 JSON 响应:
Go
Java
Node.js
Python
获取数据集详情
以下示例展示了如何获取有关数据集的详细信息。
控制台
如需查看数据集中的数据存储区,请执行以下操作:
- 在 Google Cloud Console 中,转到“数据集”页面。
- 点击要查看其数据存储的数据集的 ID。
gcloud
要查看有关数据集的详细信息,请运行 gcloud healthcare datasets describe
命令。
gcloud healthcare datasets describe DATASET_ID \ --location=LOCATION
如果请求成功,命令提示符将显示数据集详情。
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST 和命令行
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目的 ID
- LOCATION:数据集位置
- DATASET_ID:数据集 ID
如需发送请求,请选择以下方式之一:
curl
执行以下命令:
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
执行以下命令:
$cred = gcloud auth application-default 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 面板会在页面右侧打开。您可以与此工具进行互动以发送请求。填写所有必填字段,然后点击执行。
您应该会收到类似以下内容的 JSON 响应:
Go
Java
Node.js
Python
以下示例展示了如何列出项目中的数据集。
控制台
如需列出项目中的数据集,请在 Google Cloud Console 中转到“Healthcare Datasets”页面。
gcloud
要列出项目中的数据集,请运行 gcloud healthcare datasets list
命令:
gcloud healthcare datasets list
如果请求成功,命令提示符将列出数据集:
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST 和命令行
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目的 ID
- LOCATION:数据集位置
如需发送请求,请选择以下方式之一:
curl
执行以下命令:
curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
PowerShell
执行以下命令:
$cred = gcloud auth application-default 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 面板会在页面右侧打开。您可以与此工具进行互动以发送请求。填写所有必填字段,然后点击执行。
您应该会收到类似以下内容的 JSON 响应:
Go
Java
Node.js
Python
删除数据集
以下示例展示了如何删除数据集。
控制台
要删除数据集,请执行以下操作:
- 在 Google Cloud Console 中,转到“数据集”页面。
- 选择要删除的数据集,然后点击删除。
- 如要确认,请输入数据集标识符,然后点击删除。
gcloud
要删除数据集,请运行 gcloud healthcare datasets delete
命令:
运行
delete
命令:gcloud healthcare datasets delete DATASET_ID \ --location=LOCATION
要确认,请键入 Y。
如果请求成功,命令提示符将显示:
Deleted dataset [DATASET_ID]
REST 和命令行
在使用任何请求数据之前,请先进行以下替换:
- PROJECT_ID:您的 Google Cloud 项目的 ID
- LOCATION:数据集位置
- DATASET_ID:数据集 ID
如需发送请求,请选择以下方式之一:
curl
执行以下命令:
curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
执行以下命令:
$cred = gcloud auth application-default 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 面板会在页面右侧打开。您可以与此工具进行互动以发送请求。填写所有必填字段,然后点击执行。
您应该会收到类似以下内容的 JSON 响应: