Gesundheitsdaten mit der Google Cloud CLI speichern

Gesundheitsdaten mit der Google Cloud CLI speichern

Auf dieser Seite erfahren Sie, wie Sie mit der Cloud Healthcare API und der Google Cloud CLI die folgenden Aufgaben ausführen:

1. ein Cloud Healthcare API-Dataset erstellen
2. Erstellen Sie einen der folgenden Datenspeicher im Dataset:
• DICOM-Speicher (Digital Imaging and Communications in Medicine)
• FHIR-Speicher (Fast Healthcare Interoperability Resources)
• Health Level Seven International Version 2-Speicher (HL7v2)
3. DICOM-, FHIR- und HL7v2-Daten speichern und DICOM-Metadaten aufrufen.

Wenn Sie nur mit einem Datenspeichertyp arbeiten möchten, können Sie mit diesem Abschnitt der Kurzanleitung direkt fortfahren, nachdem Sie die Schritte in Vorbereitung und Ein Dataset erstellen ausgeführt haben.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
Installieren Sie die Google Cloud CLI.
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.
Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind
• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen
Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.
• So erstellen Sie ein Google Cloud -Projekt:

  gcloud projects create PROJECT_ID

  Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud -Projekt, das Sie erstellen.

• Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .
Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.
Aktivieren Sie die Cloud Healthcare API:
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen
gcloud services enable healthcare.googleapis.com
Weisen Sie Ihrem Nutzerkonto Rollen zu. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Ersetzen Sie Folgendes:
• PROJECT_ID: Ihre Projekt-ID.
• USER_IDENTIFIER: Die Kennung für Ihr Nutzerkonto . Beispiel: [e-mail]
• ROLE: Die IAM-Rolle, die Sie Ihrem Nutzerkonto zuweisen.

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
• Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere Informationen zum Zuweisen von Rollen

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

• So erstellen Sie ein Google Cloud -Projekt:

  gcloud projects create PROJECT_ID

  Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud -Projekt, das Sie erstellen.

• Wählen Sie das von Ihnen erstellte Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

Aktivieren Sie die Cloud Healthcare API:

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

gcloud services enable healthcare.googleapis.com

Weisen Sie Ihrem Nutzerkonto Rollen zu. Führen Sie den folgenden Befehl für jede der folgenden IAM-Rollen einmal aus: roles/healthcare.datasetAdmin, roles/healthcare.fhirStoreAdmin, roles/healthcare.dicomStoreAdmin, roles/healthcare.hl7V2StoreAdmin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Ersetzen Sie Folgendes:

• PROJECT_ID: Ihre Projekt-ID.
• USER_IDENTIFIER: Die Kennung für Ihr Nutzerkonto . Beispiel: [e-mail]
• ROLE: Die IAM-Rolle, die Sie Ihrem Nutzerkonto zuweisen.

Dataset erstellen

Datasets enthalten Datenspeicher und Datenspeicher enthalten medizinische Daten. Um die Cloud Healthcare API verwenden zu können, müssen Sie mindestens ein Dataset erstellen.

Im folgenden Beispiel wird gezeigt, wie Sie ein Dataset mit dem Namen my-dataset in der Region us-central1 erstellen. Sie verwenden das Dataset in dieser Kurzanleitung, um DICOM-, FHIR- und HL7v2-Speicher zu erstellen.

gcloud

Erstellen Sie ein Dataset mit dem Befehl gcloud healthcare datasets create.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare datasets create my-dataset \
  --project=PROJECT_ID \
  --location=us-central1

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare datasets create my-dataset `
  --project=PROJECT_ID `
  --location=us-central1

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare datasets create my-dataset ^
  --project=PROJECT_ID ^
  --location=us-central1

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Antwort

Create request issued for: [my-dataset]
Created dataset [my-dataset].

Wählen Sie einen der folgenden Abschnitte aus, um diese Kurzanleitung abzuschließen:

• DICOM-Instanz speichern und ansehen
• FHIR-Ressourcen speichern
• HL7v2-Nachricht speichern

DICOM-Instanz speichern und ansehen

In diesem Abschnitt wird beschrieben, wie Sie die folgenden Aufgaben ausführen:

1. DICOM-Speicher erstellen
2. DICOM-Instanz aus einem öffentlichen Cloud Storage-Bucket in den DICOM-Speicher importieren.
3. Metadaten der DICOM-Instanz aufrufen

Die Cloud Healthcare API implementiert den DICOMweb-Standard zum Speichern und Abrufen von medizinischen Bilddaten.

DICOM-Speicher erstellen

DICOM-Speicher befinden sich in Datasets und enthalten DICOM-Instanzen. Das folgende Beispiel zeigt, wie Sie einen DICOM-Speicher mit dem Namen my-dicom-store erstellen.

gcloud

Erstellen Sie einen DICOM-Speicher mit dem Befehl gcloud healthcare dicom-stores create.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare dicom-stores create my-dicom-store \
  --project=PROJECT_ID \
  --dataset=my-dataset \
  --location=us-central1

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare dicom-stores create my-dicom-store `
  --project=PROJECT_ID `
  --dataset=my-dataset `
  --location=us-central1

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare dicom-stores create my-dicom-store ^
  --project=PROJECT_ID ^
  --dataset=my-dataset ^
  --location=us-central1

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Antwort

Created dicomStore [my-dicom-store].

DICOM-Instanz importieren

Beispiele für DICOM-Daten finden Sie im Cloud Storage-Bucket gs://gcs-public-data--healthcare-nih-chest-xray.

gcloud

Importieren Sie die gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm-Instanz mit dem Befehl gcloud healthcare dicom-stores import.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare dicom-stores import gcs my-dicom-store \
  --project=PROJECT_ID \
  --dataset=my-dataset \
  --location=us-central1 \
  --gcs-uri=gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare dicom-stores import gcs my-dicom-store `
  --project=PROJECT_ID `
  --dataset=my-dataset `
  --location=us-central1 `
  --gcs-uri=gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare dicom-stores import gcs my-dicom-store ^
  --project=PROJECT_ID ^
  --dataset=my-dataset ^
  --location=us-central1 ^
  --gcs-uri=gs://gcs-public-data--healthcare-nih-chest-xray/dicom/00000001_000.dcm

In dieser Ausgabe gilt:

• PROJECT_ID, us-central1, my-dataset, my-dicom-store sind die Werte, die Sie bei der Ausführung des Befehls angegeben haben
• OPERATION_ID: Eine Kennung für den Vorgang mit langer Ausführungszeit, der von der Cloud Healthcare API bereitgestellt wird, wenn Sie eine DICOM-Instanz importieren. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Das Importieren einer DICOM-Instanz ist in der Regel ein schneller Vorgang, sodass die Ausgabe fast sofort zurückgegeben wird.

Antwort

Request issued for: [my-dicom-store]
Waiting for operation [projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID] to complete...done.
name: projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store

Metadaten der DICOM-Instanz ansehen

Die gcloud CLI unterstützt keine DICOMweb-Transaktionen wie das Anzeigen oder Abrufen von Instanzen. Stattdessen können Sie das DICOMweb-Befehlszeilentool von Google verwenden, das mit Python ausgeführt wird. Informationen zum Einrichten von Python auf Google Cloudfinden Sie unter Python-Entwicklungsumgebung einrichten.

Führen Sie die folgenden Schritte aus, um die Metadaten der DICOM-Instanz mit dem DICOMweb-Befehlszeilentool aufzurufen:

1. Installieren Sie das DICOMweb-Befehlszeilentool mit Pip:

   pip install https://github.com/GoogleCloudPlatform/healthcare-api-dicomweb-cli/archive/v1.0.zip
   

2. Aktualisieren Sie die Variable PATH, um den Installationsort dcmweb aufzunehmen:

   export PATH="$HOME/bin:$PATH"
   

3. Rufen Sie die Metadaten der DICOM-Instanz auf:

   dcmweb \
     https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/dicomStores/my-dicom-store/dicomWeb \
     search instances

   Ersetzen Sie PROJECT_ID durch die ID des Google Cloud Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben.

   Die Ausgabe sieht so aus. Informationen zu den Feldern in der Ausgabe finden Sie unter Attribute des SOP Common Module.

   [
     {
       "00080016": {
         "Value": [
           "1.2.840.10008.5.1.4.1.1.7"
         ],
         "vr": "UI"
       },
       "00080018": {
         "Value": [
           "1.3.6.1.4.1.11129.5.5.153751009835107614666834563294684339746480"
         ],
         "vr": "UI"
       },
       "00080060": {
         "Value": [
           "DX"
         ],
         "vr": "CS"
       },
       "00100020": {
         "Value": [
           "1"
         ],
         "vr": "LO"
       },
       "00100040": {
         "Value": [
           "M"
         ],
         "vr": "CS"
       },
       "0020000D": {
         "Value": [
           "1.3.6.1.4.1.11129.5.5.111396399361969898205364400549799252857604"
         ],
         "vr": "UI"
       },
       "0020000E": {
         "Value": [
           "1.3.6.1.4.1.11129.5.5.195628213694300498946760767481291263511724"
         ],
         "vr": "UI"
       },
       "00280010": {
         "Value": [
           1024
         ],
         "vr": "US"
       },
       "00280011": {
         "Value": [
           1024
         ],
         "vr": "US"
       },
       "00280100": {
         "Value": [
           8
         ],
         "vr": "US"
       }
     }
   ]
   

Nachdem Sie die DICOM-Instanz in die Cloud Healthcare API importiert und ihre Metadaten aufgerufen haben, fahren Sie mit Bereinigen fort, um zu vermeiden, dass Ihrem Google Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden.

Informationen zu den nächsten Schritten, z. B. zum Suchen oder Abrufen von DICOM-Bildern mit dem DICOMweb-Standard in der Cloud Healthcare API, finden Sie unter Nächste Schritte.

FHIR-Ressourcen speichern

Hinweis :Die Cloud Healthcare API REST API implementiert den FHIR-Standard zum Verwalten von FHIR-Daten. Die gcloud CLI unterstützt den FHIR-Standard nicht, bietet aber Alternativen für Vorgänge wie das Speichern von FHIR-Ressourcen.

In diesem Abschnitt wird beschrieben, wie Sie die folgenden Aufgaben ausführen:

1. Erstellen Sie einen FHIR-Speicher.
2. Importieren Sie FHIR-Ressourcen aus einem öffentlichen Cloud Storage-Bucket in den FHIR-Speicher.

FHIR-Speicher erstellen

FHIR-Speicher befinden sich in Datasets und enthalten FHIR-Ressourcen. Im folgenden Beispiel wird gezeigt, wie Sie einen FHIR-Speicher mit dem Namen my-fhir-store erstellen, der FHIR-Version R4 verwendet.

gcloud

Erstellen Sie mit dem Befehl gcloud healthcare fhir-stores create einen FHIR-Speicher.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare fhir-stores create my-fhir-store \
  --project=PROJECT_ID \
  --dataset=my-dataset \
  --location=us-central1 \
  --version=R4

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare fhir-stores create my-fhir-store `
  --project=PROJECT_ID `
  --dataset=my-dataset `
  --location=us-central1 `
  --version=R4

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare fhir-stores create my-fhir-store ^
  --project=PROJECT_ID ^
  --dataset=my-dataset ^
  --location=us-central1 ^
  --version=R4

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Antwort

Created fhirStore [my-fhir-store].

FHIR-Ressourcen importieren

Beispiele für FHIR-Daten finden Sie im Cloud Storage-Bucket gs://gcp-public-data--synthea-fhir-data-10-patients.

gcloud

Importieren Sie die FHIR-Ressourcen in gs://gcp-public-data--synthea-fhir-data-10-patients mit dem Befehl gcloud healthcare fhir-stores import.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare fhir-stores import gcs my-fhir-store \
  --project=PROJECT_ID \
  --dataset=my-dataset \
  --location=us-central1 \
  --gcs-uri=gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/*.ndjson \
  --content-structure=RESOURCE

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare fhir-stores import gcs my-fhir-store `
  --project=PROJECT_ID `
  --dataset=my-dataset `
  --location=us-central1 `
  --gcs-uri=gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/*.ndjson `
  --content-structure=RESOURCE

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare fhir-stores import gcs my-fhir-store ^
  --project=PROJECT_ID ^
  --dataset=my-dataset ^
  --location=us-central1 ^
  --gcs-uri=gs://gcp-public-data--synthea-fhir-data-10-patients/fhir_r4_ndjson/*.ndjson ^
  --content-structure=RESOURCE

In dieser Ausgabe gilt:

• PROJECT_ID, us-central1, my-dataset, my-fhir-store sind die Werte, die Sie bei der Ausführung des Befehls angegeben haben
• OPERATION_ID: Eine Kennung für den Vorgang mit langer Ausführungszeit, die von der Cloud Healthcare API bereitgestellt wird, wenn Sie eine FHIR-Ressource importieren. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Das Importieren der FHIR-Ressourcen dauert etwa ein bis zwei Minuten.
• R4: die FHIR-Speicherversion

Antwort

Request issued for: [my-fhir-store]
Waiting for operation [projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID] to complete...done.
name: projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/fhirStores/my-fhir-store
version: R4

Nachdem Sie die FHIR-Ressourcen in die Cloud Healthcare API importiert haben, fahren Sie mit dem Abschnitt Bereinigen fort, um zu vermeiden, dass Ihrem Google Cloud Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden.

Informationen zu den nächsten Schritten, z. B. zum Aufrufen und Suchen von FHIR-Ressourcen, finden Sie unter Nächste Schritte.

HL7v2-Nachricht speichern

In diesem Abschnitt wird beschrieben, wie Sie die folgenden Aufgaben ausführen:

1. HL7v2-Speicher erstellen.
2. Importieren Sie eine HL7v2-Nachricht aus einem öffentlichen Cloud Storage-Bucket in den HL7v2-Speicher.

Die HL7v2-Implementierung in der Cloud Healthcare API entspricht dem HL7v2-Standard.

HL7v2-Speicher erstellen

HL7v2-Speicher befinden sich in Datasets und enthalten HL7v2-Nachrichten. Im folgenden Beispiel wird gezeigt, wie Sie einen HL7v2-Speicher mit dem Namen my-hl7v2-store erstellen.

gcloud

Erstellen Sie mit dem Befehl gcloud healthcare hl7v2-stores create einen HL7v2-Speicher.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare hl7v2-stores create my-hl7v2-store \
  --project=PROJECT_ID \
  --dataset=my-dataset \
  --location=us-central1

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare hl7v2-stores create my-hl7v2-store `
  --project=PROJECT_ID `
  --dataset=my-dataset `
  --location=us-central1

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare hl7v2-stores create my-hl7v2-store ^
  --project=PROJECT_ID ^
  --dataset=my-dataset ^
  --location=us-central1

Sie sollten eine Antwort ähnlich der folgenden erhalten:

Antwort

Created hl7v2Store [my-hl7v2-store].

HL7v2-Nachrichten importieren

gcloud

Importieren Sie die HL7v2-Nachricht gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson mit dem Befehl gcloud healthcare hl7v2-stores import.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare hl7v2-stores import gcs my-hl7v2-store \
  --project=PROJECT_ID \
  --dataset=my-dataset \
  --location=us-central1 \
  --gcs-uri=gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare hl7v2-stores import gcs my-hl7v2-store `
  --project=PROJECT_ID `
  --dataset=my-dataset `
  --location=us-central1 `
  --gcs-uri=gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare hl7v2-stores import gcs my-hl7v2-store ^
  --project=PROJECT_ID ^
  --dataset=my-dataset ^
  --location=us-central1 ^
  --gcs-uri=gs://cloud-samples-data/healthcare/hl7v2/messages.ndjson

In dieser Ausgabe gilt:

• PROJECT_ID, us-central1, my-dataset, my-hl7v2-store sind die Werte, die Sie bei der Ausführung des Befehls angegeben haben
• OPERATION_ID: Eine Kennung für den Vorgang mit langer Ausführungszeit, die von der Cloud Healthcare API bereitgestellt wird, wenn Sie eine HL7v2-Nachricht importieren. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Das Importieren einer HL7v2-Nachricht geht in der Regel schnell, sodass die Ausgabe fast sofort zurückgegeben wird.

Antwort

Request issued for: [my-hl7v2-store]
Waiting for operation [projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/operations/OPERATION_ID] to complete...done.
name: projects/PROJECT_ID/locations/us-central1/datasets/my-dataset/hl7V2Stores/my-hl7v2-store

Nachdem Sie die HL7v2-Nachricht in die Cloud Healthcare API importiert haben, fahren Sie mit dem Abschnitt Bereinigen fort, um zu vermeiden, dass Ihrem Google Cloud Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden.

Informationen zu den nächsten Schritten, z. B. zum Anzeigen des Inhalts einer HL7v2-Nachricht, finden Sie unter Nächste Schritte.

Bereinigen

Löschen Sie das Projekt von Google Cloud zusammen mit den Ressourcen, damit Ihrem Konto von Google Cloud die auf dieser Seite verwendeten Ressourcen nicht in Rechnung gestellt werden.

Wenn Sie ein neues Projekt für diese Kurzanleitung erstellt haben, führen Sie die Schritte unter Projekt löschen aus. Andernfalls führen Sie die Schritte unter Dataset löschen aus.

Optional: Widerrufen Sie Anmeldedaten von der gcloud-CLI.

gcloud auth revoke

Projekt löschen

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, zum Beispiel eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, anstatt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

Google Cloud -Projekt löschen:

gcloud projects delete PROJECT_ID

Dataset löschen

Wenn Sie das in dieser Kurzanleitung erstellte Dataset nicht mehr benötigen, können Sie es löschen. Durch das Löschen eines Datasets werden das Dataset und alle darin enthaltenen FHIR-, HL7v2- oder DICOM-Speicher endgültig gelöscht.

gcloud

Löschen Sie ein Dataset mit dem Befehl gcloud healthcare datasets delete.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die ID des Google Cloud -Projekts, das Sie unter Vorbereitung erstellt oder ausgewählt haben

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare datasets delete my-dataset \
  --project=PROJECT_ID \
  --location=us-central1

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare datasets delete my-dataset `
  --project=PROJECT_ID `
  --location=us-central1

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud healthcare datasets delete my-dataset ^
  --project=PROJECT_ID ^
  --location=us-central1

Geben Sie zur Bestätigung Y ein. Sie sollten eine Antwort ähnlich der folgenden erhalten:

Antwort

You are about to delete dataset [my-dataset]

Do you want to continue (Y/n)?  Y

Deleted dataset [my-dataset].

Wie ist es gelaufen?

Es hat funktioniert.

Prima! Was hat Ihnen an der Kurzanleitung gefallen? Was hätten wir besser machen können? Geben Sie uns Feedback..

Es hat nicht funktioniert.

Wir bedauern, dass Ihre Erwartungen nicht erfüllt wurden. Welches Problem ist aufgetreten? Wir werden nach einer Lösung suchen.

Nächste Schritte

In den folgenden Abschnitten finden Sie allgemeine Informationen zur Cloud Healthcare API und dazu, wie Sie die Aufgaben in dieser Kurzanleitung mit einer anderen Schnittstelle ausführen:

• Übersicht über die Konzepte der Cloud Healthcare API lesen
• Gesundheitsdaten mit curl oder PowerShell speichern
• Gesundheitsdaten mit Clientbibliotheken speichern
• Gesundheitsdaten mit der gcloud CLI speichern

DICOM

• DICOM-Speicher erstellen und verwalten
• PACS mit der Cloud Healthcare API verbinden
• DICOMweb-Standard verwenden
• DICOM-Daten mit Cloud Storage importieren und exportieren

Informationen dazu, wie die Cloud Healthcare API den DICOMweb-Standard umsetzt, finden Sie in der DICOM-Konformitätserklärung.

FHIR

• FHIR-Speicher erstellen und verwalten
• FHIR-Ressourcen erstellen und verwalten
• FHIR-Daten mit Cloud Storage importieren und exportieren

Informationen dazu, wie die Cloud Healthcare API den FHIR-Standard umsetzt, finden Sie in der FHIR-Konformitätserklärung.

HL7v2

• HL7V2-Speicher erstellen und verwalten
• HL7v2-Nachrichten erstellen und verwalten
• HL7v2-Nachrichten über TCP/IP-Verbindungen übertragen
• HL7v2-Nachrichten mit Cloud Storage importieren und exportieren