Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Transmitir cambios de recursos FHIR a BigQuery

En esta página, se explica cómo configurar la API de Cloud Healthcare para exportar cambios de recursos a BigQuery cada vez un recurso FHIR se crea, actualiza, aplica parches o se borra en un almacén FHIR.

Configura permisos de BigQuery

Para transmitir los cambios de los recursos de FHIR a BigQuery, debes otorgar permisos adicionales a la cuenta de servicio del Agente de servicio de Cloud Healthcare. Para obtener más información, consulta Permisos de BigQuery para el almacén de datos de FHIR.

Transmite cambios de recursos de FHIR

En los siguientes ejemplos, se muestra cómo transmitir los cambios de los recursos de FHIR en un conjunto de datos de BigQuery.

Para obtener más información, consulta el campo streamConfigs en el recurso del almacén FHIR.

curl

Para habilitar la transmisión de BigQuery, debes actualizar el campo streamConfigs del almacén FHIR. Para actualizar el almacén de FHIR, realiza una solicitud PATCH con la siguiente información:

  • El conjunto de datos superior
  • El almacén de FHIR
  • El conjunto de datos de BigQuery
  • El proyecto de BigQuery
  • Una máscara de actualización
  • Un token de acceso

En el siguiente ejemplo, se muestra una solicitud PATCH mediante curl.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data "{
      'streamConfigs': [
        {
          'bigqueryDestination': {
            'datasetUri': 'bq://BIGQUERY_PROJECT_ID.BIGQUERY_DATASET_ID',
            'schemaConfig': {
              'schemaType': 'ANALYTICS'
            }
          }
        }
      ]
    }" "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=streamConfigs"

Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID",
  'streamConfigs': [
   {
     'bigqueryDestination': {
       'datasetUri': 'bq://BIGQUERY_PROJECT_ID.BIGQUERY_DATASET_ID',
       'schemaConfig': {
         'schemaType': 'ANALYTICS'
       }
     }
   }
  ]
}

Después de configurar la transmisión de BigQuery, la API de Cloud Healthcare inserta una fila nueva en una tabla de BigQuery cada vez que se crea, se actualiza, o se borra un recurso de FHIR, o bien cuando se le aplica un parche uno.

PowerShell

Para habilitar la transmisión de BigQuery, debes actualizar el campo streamConfigs del almacén FHIR. Para actualizar el almacén de FHIR, realiza una solicitud PATCH con la siguiente información:

  • El conjunto de datos superior
  • El almacén de FHIR
  • El conjunto de datos de BigQuery
  • El proyecto de BigQuery
  • Una máscara de actualización
  • Un token de acceso

En el siguiente ejemplo, se muestra una solicitud PATCH mediante Windows PowerShell.

$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 "{
      'streamConfigs': [
        {
          'bigqueryDestination': {
            'datasetUri': 'bq://BIGQUERY_PROJECT_ID.BIGQUERY_DATASET_ID',
            'schemaConfig': {
              'schemaType': 'ANALYTICS'
            }
          }
        }
      ]
  }" `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=streamConfigs" | Select-Object -Expand Content

Si la solicitud tiene éxito, se mostrará la respuesta en formato JSON en el servidor:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID",
  'streamConfigs': [
   {
     'bigqueryDestination': {
       'datasetUri': 'bq://BIGQUERY_PROJECT_ID.BIGQUERY_DATASET_ID',
       'schemaConfig': {
         'schemaType': 'ANALYTICS'
       }
     }
   }
  ]
}

Después de configurar la transmisión de BigQuery, la API de Cloud Healthcare inserta una fila nueva en una tabla de BigQuery cada vez que se crea, se actualiza, o se borra un recurso de FHIR, o bien cuando se le aplica un parche uno.

Soluciona problemas de transmisión de FHIR

Si se producen errores cuando se envían cambios de recursos a BigQuery, los errores se registran en Cloud Logging. Para obtener más información, consulta Visualiza los registros de errores en Cloud Logging.