Exporta metadatos y anotaciones de un conjunto de datos

Console

1. En la Google Cloud consola, en la sección Agent Platform, ve a la página Conjuntos de datos.

   Ir a la página Conjuntos de datos

2. En la lista desplegable Región, selecciona la ubicación en la que se almacena el Dataset.

3. Busca la fila del Dataset. Puedes exportar metadatos y anotaciones para todos los conjuntos de anotaciones o un conjunto de anotaciones específico:

   • Si quieres exportar metadatos y anotaciones para todos los conjuntos de anotaciones de Dataset, haz clic en Ver más more_vert y luego, haz clic en Exportar conjunto de datos.

     Esto le indica a Agent Platform que debe crear un conjunto de archivos de líneas JSON para cada conjunto de anotaciones.

   • Si deseas exportar metadatos y anotaciones para un conjunto de anotaciones específico, haz lo siguiente:

     1. Haz clic en Expandir nodo arrow_drop_down para ver las filas de cada conjunto de anotaciones de Dataset.

     2. En la fila del conjunto de anotaciones que deseas exportar, haz clic en Ver más more_vert y, luego, en Exportar conjunto de anotaciones.

     Esto le indica a Agent Platform que debe crear un conjunto de archivos de líneas JSON para el conjunto de anotaciones que especifiques.

4. En el cuadro de diálogo Exportar datos, ingresa un directorio de Cloud Storage en el que quieras que Agent Platform guarde los archivos de líneas JSON exportados. Haz clic en Exportar.

REST

Obtén el ID del Dataset

Para exportar un Dataset, debes conocer el ID numérico de Dataset. Si conoces el nombre visible del Dataset, pero no su ID, expande la siguiente sección para saber cómo obtener el ID con la API:

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?filter=displayName=DATASET_DISPLAY_NAME

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?filter=displayName=DATASET_DISPLAY_NAME"

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?filter=displayName=DATASET_DISPLAY_NAME" | Select-Object -Expand Content

{
  "datasets": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID",
      "displayName": "DATASET_DISPLAY_NAME",
      ...
    }
  ]
}

Como alternativa, puedes obtener el ID de Dataset desde la Google Cloud consola: ve a la página Conjuntos de datos de Agent Platform y busca el número en la columna ID.

Ir a la página Conjuntos de datos

Exportar uno o más conjuntos de anotaciones

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• LOCATION: Es la ubicación en la que se almacena Dataset. Por ejemplo, us-central1.

• PROJECT_ID: Tu ID del proyecto. .

• DATASET_ID: es el ID numérico del Dataset.

• EXPORT_DIRECTORY: es el URI de Cloud Storage (que comienza con gs://) de un directorio en el que quieres que Agent Platform guarde los archivos de líneas JSON exportados. Debe estar en un bucket de Cloud Storage al que puedas acceder, aunque no hace falta que el directorio ya esté creado.

• FILTER: es una string de filtro que determina qué conjuntos de anotaciones se exportan.

  • Si quieres exportar metadatos y anotaciones para todos los conjuntos de anotaciones del Dataset,reemplaza FILTER por una string vacía (u omite el campo annotationsFilter del cuerpo de la solicitud por completo). Esto le indica a Agent Platform que debe crear un conjunto de archivos de líneas JSON para cada conjunto de anotaciones.

  • Si deseas exportar metadatos y anotaciones para una anotación específica set, reemplaza FILTER por lo siguiente:

    labels.aiplatform.googleapis.com/annotation_set_name=ANNOTATION_SET_ID
    

    Esto le indica a Agent Platform que debe crear un conjunto de archivos de líneas JSON para el conjunto de anotaciones con el ID numérico ANNOTATION_SET_ID.

    Para encontrar el ID numérico del conjunto de anotaciones que deseas especificar, visualiza el conjunto de anotaciones en la Google Cloud consola y busca el valor que le sigue a annotationSetId en la URL.

Método HTTP y URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID:export

Cuerpo JSON de la solicitud:

{
  "exportConfig": {
    "gcsDestination": {
      "outputUriPrefix": "EXPORT_DIRECTORY"
    },
    "annotationsFilter": "FILTER"
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID:export"

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID:export" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.ExportDataOperationMetadata",
    "genericMetadata": {
      "createTime": "2021-02-17T00:54:58.827429Z",
      "updateTime": "2021-02-17T00:54:58.827429Z"
    },
    "gcsOutputDirectory": "EXPORT_DIRECTORY/export-data-DATASET_DISPLAY_NAME-2021-02-17T00:54:58.734772Z"
  }
}

Algunas solicitudes inician operaciones de larga duración que requieren tiempo para completarse. Estas solicitudes devuelven un nombre de operación que puedes usar para ver el estado de la operación o cancelarla. Agent Platform proporciona métodos auxiliares para realizar llamadas en operaciones de larga duración. Para obtener más información, consulta Trabaja con operaciones de larga duración.