Auf dieser Seite wird erläutert, wie Sie Datasets erstellen, bearbeiten, anzeigen und löschen können. Eine Übersicht der Datasets finden Sie in der Dokumentation zum Datenmodell.
Dataset erstellen
Um die Cloud Healthcare API verwenden zu können, müssen Sie mindestens ein Dataset erstellen.
Die folgenden Beispiele zeigen, wie Sie ein Dataset erstellen.
Console
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Klicken Sie auf Dataset erstellen.
- Wählen Sie eine Dataset-ID aus, die in Ihrem Projekt und Ihrer Region eindeutig ist. Wenn die ID nicht eindeutig ist, schlägt das Erstellen des Datasets fehl.
- Wählen Sie die Region aus, in der sich das Dataset dauerhaft befindet, und klicken Sie dann auf Erstellen.
Das neue Dataset wird in der Liste angezeigt.
gcloud
Führen Sie den Befehl gcloud healthcare datasets create
aus, um ein Dataset zu erstellen:
- Die DATASET_ID muss innerhalb der Region eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Die Region kann
us-central1
,us-west2
,us-east4
,europe-west2
,europe-west4
,europe-west6
,northamerica-northeast1
,southamerica-east1
sein.asia-east2
,asia-northeast1
,asia-southeast1
,australia-southeast1
oderus
. Wenn Sie die Standardregion für das Projekt verwenden möchten, lassen Sie die Option--location
weg.
gcloud healthcare datasets create DATASET_ID \ --location=LOCATION
In der Befehlszeile werden die Vorgangs-ID und nach Abschluss des Vorgangs eine Bestätigung angezeigt, dass das Dataset erstellt wurde:
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].
Führen Sie den Befehl gcloud healthcare operations describe
aus und geben Sie OPERATION_ID aus der Antwort an, um weitere Details zum Vorgang aufzurufen:
gcloud healthcare operations describe OPERATION_ID \ --dataset=DATASET_ID
Die Antwort enthält 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
API
Verwenden Sie zum Erstellen eines Datasets die Methode projects.locations.datasets.create
.
curl
Zum Erstellen eines Datasets senden Sie eine POST
-Anfrage und geben die folgenden Informationen an:
- Ein Name für das Dataset. Die Dataset-ID muss in ihrer Region eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine POST
-Anfrage mit curl
.
curl -X POST \ --data "" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" }
Die Antwort enthält einen Vorgangsnamen. Mit der Methode Operation get
können Sie den Status des Vorgangs verfolgen und weitere Details anzeigen:
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/operations/OPERATION_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort mit dem Status des Vorgangs im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset", "createTime": "CREATE_TIME", "endTime": "END_TIME", "logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset", "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" } }
PowerShell
Zum Erstellen eines Datasets senden Sie eine POST
-Anfrage und geben die folgenden Informationen an:
- Ein Name für das Dataset. Die Dataset-ID muss in ihrer Region eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine POST
-Anfrage mit Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" }
Die Antwort enthält einen Vorgangsnamen. Mit der Methode Operation get
können Sie den Status des Vorgangs verfolgen und weitere Details anzeigen:
$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/operations/OPERATION_ID" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort mit dem Status des Vorgangs im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset", "createTime": "CREATE_TIME", "endTime": "END_TIME", "logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL" }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset", "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" } }
Go
Java
Node.js
Python
Dataset bearbeiten
Die folgenden Beispiele zeigen, wie Sie ein vorhandenes Dataset bearbeiten.
Console
Die Cloud Console unterstützt das Bearbeiten eines Datasets im Gesundheitswesen nicht. Verwenden Sie stattdessen curl
, Windows PowerShell oder Ihre bevorzugte Sprache.
gcloud
Zum Bearbeiten eines Datasets führen Sie den Befehl gcloud healthcare datasets update
aus und geben dabei die neue Zeitzone an. Sie können beispielsweise die Zeitzone auf "Canada/Eastern" festlegen.
gcloud healthcare datasets update DATASET_ID \ --location=LOCATION \ --time-zone=TIME_ZONE
Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die Vorgangs- und Dataset-Details angezeigt:
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
API
Verwenden Sie zum bearbeiten eines Datasets die Methode projects.locations.datasets.patch
.
curl
Zum Bearbeiten eines Datasets senden Sie eine PATCH
-Anfrage und geben die folgenden Informationen an:
- Der Name des Datasets
- Die zu aktualisierenden Metadaten
- Eine Aktualisierungsmaske
- Ein Zugriffstoken
Das folgende Beispiel zeigt, wie Sie die Zeitzone aktualisieren, indem Sie eine PATCH
-Anfrage mit curl
stellen.
Ersetzen Sie die Variable TIMEZONE
durch einen Wert wie UTC
. Der Zeitzonenwert muss in Großbuchstaben angegeben werden.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'timeZone': 'TIMEZONE' }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" "timeZone": "TIMEZONE" }
PowerShell
Zum Bearbeiten eines Datasets senden Sie eine PATCH
-Anfrage und geben die folgenden Informationen an:
- Der Name des Datasets
- Die zu aktualisierenden Metadaten
- Eine Aktualisierungsmaske
- Ein Zugriffstoken
Das folgende Beispiel zeigt, wie Sie die Zeitzone aktualisieren, indem Sie eine PATCH
-Anfrage mit Windows PowerShell stellen.
Ersetzen Sie die Variable TIMEZONE
durch einen Wert wie UTC
. Der Zeitzonenwert muss in Großbuchstaben angegeben werden.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Patch ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'timeZone': 'TIMEZONE' }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" "timeZone": "TIMEZONE" }
Go
Java
Node.js
Python
Dataset-Details abrufen
Die folgenden Beispiele zeigen, wie Sie Details zu einem Dataset abrufen können.
Console
So zeigen Sie die Datenspeicher in einem Dataset an:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Klicken Sie auf die ID des Datasets, dessen Datenspeicher Sie anzeigen möchten.
gcloud
Führen Sie den Befehl gcloud healthcare datasets describe
aus, um Details zu einem Dataset aufzurufen:
gcloud healthcare datasets describe DATASET_ID \ --location=LOCATION
Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die Dataset-Details angezeigt.
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
API
Wenn Sie Details zu einem Dataset abrufen möchten, verwenden Sie die Methode projects.locations.datasets.get
.
curl
Wenn Sie Details zu einem Dataset abrufen möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit 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"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" "timeZone": "UTC" }
PowerShell
Wenn Sie Details zu einem Dataset abrufen möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit Windows 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
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" "timeZone": "UTC" }
Go
Java
Node.js
Python
Die folgenden Beispiele zeigen, wie Sie die Datasets in Ihrem Projekt auflisten.
Console
Um die Datasets in Ihrem Projekt aufzulisten, rufen Sie in der Cloud Console die Seite "Healthcare-Datasets" auf.
gcloud
Führen Sie den Befehl gcloud healthcare datasets list
aus, um die Datasets in Ihrem Projekt aufzulisten:
gcloud healthcare datasets list
Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die Datasets aufgelistet:
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
API
Zum Auflisten der Datasets in Ihrem Projekt verwenden Sie die Methode projects.locations.datasets.list
.
curl
Wenn Sie die Datasets in Ihrem Projekt auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name Ihres Projekts.
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit 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"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "datasets": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID", "timeZone": "UTC" }, { ... ... } ] }
PowerShell
Wenn Sie die Datasets in Ihrem Projekt auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name Ihres Projekts.
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit Windows 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
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{ "datasets": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID", "timeZone": "UTC" }, { ... ... } ] }
Go
Java
Node.js
Python
Dataset löschen
Die folgenden Beispiele zeigen, wie Sie ein Dataset löschen.
Console
So löschen Sie ein Dataset:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Wählen Sie das Dataset aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie zur Bestätigung die Dataset-ID ein und klicken Sie dann auf Löschen.
gcloud
Führen Sie den Befehl gcloud healthcare datasets delete
aus, um ein Dataset zu löschen:
Führen Sie den Befehl
delete
aus:gcloud healthcare datasets delete DATASET_ID \ --location=LOCATION
Geben Sie zur Bestätigung Y ein.
Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung Folgendes angezeigt:
Deleted dataset [DATASET_ID]
API
Zum Löschen eines Datasets verwenden Sie die Methode projects.locations.datasets.delete
.
curl
Zum Löschen eines Datasets senden Sie eine DELETE
-Anfrage und geben die folgenden Informationen an:
- Der Name des Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit 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"
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{}
PowerShell
Zum Löschen eines Datasets senden Sie eine DELETE
-Anfrage und geben die folgenden Informationen an:
- Der Name des Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit Windows 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
Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:
{}
Go
Java
Node.js
Python
Nächste Schritte
- Identifizierung von sensiblen Daten aufheben
- DICOM-Speicher erstellen und verwalten
- FHIR-Speicher erstellen und verwalten
- HL7V2-Speicher erstellen und verwalten