REST Resource: projects.datasets

Recurso: Dataset

Representación de un recurso de conjunto de datos.

Representación JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
Campos
name

string

Nombre del recurso. Formato: projects/{project}/datasets/{datasetId}

displayName

string

Nombre legible por humanos, que se muestra en la IU de la consola.

Debe ser único en un proyecto.

description

string

Es una descripción de este conjunto de datos.

versionId

string

Es el ID de la versión del conjunto de datos.

usage[]

enum (Usage)

Caso de uso especificado para este conjunto de datos.

status

object (Status)

Solo salida. El estado de la versión de este conjunto de datos.

createTime

string (Timestamp format)

Solo salida. Hora en la que se creó el conjunto de datos por primera vez.

updateTime

string (Timestamp format)

Solo salida. Hora en la que se actualizaron por última vez los metadatos del conjunto de datos.

versionCreateTime

string (Timestamp format)

Solo salida. Hora en la que se creó esta versión.

versionDescription

string

Solo salida. La descripción de esta versión del conjunto de datos. Se proporciona cuando importas datos al conjunto de datos.

Campo de unión data_source. Detalles sobre la fuente de los datos para el conjunto de datos. Las direcciones (data_source) solo pueden ser una de las siguientes opciones:
localFileSource

object (LocalFileSource)

Una fuente de archivo local para el conjunto de datos en una sola carga.

gcsSource

object (GcsSource)

Una fuente de archivos de Google Cloud Storage para el conjunto de datos en una sola carga.

Uso

El uso especifica dónde se usarán los datos para informar cómo procesarlos.

Enumeradores
USAGE_UNSPECIFIED El uso de este conjunto de datos no está establecido.
USAGE_DATA_DRIVEN_STYLING Este conjunto de datos se usará para el diseño basado en datos.

LocalFileSource

Los detalles sobre la fuente de datos cuando es un archivo local.

Representación JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Campos
filename

string

Es el nombre del archivo subido.

fileFormat

enum (FileFormat)

El formato del archivo que se sube.

FileFormat

El formato del archivo que se sube.

Enumeradores
FILE_FORMAT_UNSPECIFIED Formato de archivo no especificado.
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML Archivo KML.
FILE_FORMAT_CSV .CSV.

GcsSource

Los detalles sobre la fuente de datos cuando están en Google Cloud Storage.

Representación JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Campos
inputUri

string

Es el URI de los datos de origen. Por ejemplo, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

El formato de archivo del objeto de Google Cloud Storage. Esto se usa principalmente para la validación.

Estado

Estado del conjunto de datos.

Representación JSON
{
  "state": enum (State),
  "errorMessage": string
}
Campos
state

enum (State)

Establece el estado enum.

errorMessage

string

Mensaje de error que indica el motivo del error. Estará vacío si los conjuntos de datos no tienen un estado de error.

Estado

Es una lista de estados para el conjunto de datos.

Enumeradores
STATE_UNSPECIFIED No se estableció el estado de este conjunto de datos.
STATE_IMPORTING Se están importando los datos a un conjunto de datos.
STATE_IMPORT_SUCCEEDED Los datos a un conjunto de datos se importaron correctamente.
STATE_IMPORT_FAILED No se pudieron importar los datos a un conjunto de datos.
STATE_DELETING El conjunto de datos está en proceso de eliminación.
STATE_DELETION_FAILED El estado de error de eliminación. Este estado indica que no se pudo borrar el conjunto de datos. Se puede reintentar la eliminación.
STATE_PROCESSING Se están procesando los datos.
STATE_PROCESSING_FAILED El estado de error de procesamiento. Este estado indica que se produjo un error en el procesamiento y puede informar errores.
STATE_NEEDS_REVIEW Este estado no se usa actualmente.
STATE_PUBLISHING Es el estado de publicación. Este estado indica que la publicación está en curso.
STATE_PUBLISHING_FAILED Estados de error en la publicación. Este estado indica que falló la publicación. Se puede reintentar la publicación.
STATE_COMPLETED El estado completo. Este estado representa el conjunto de datos disponible para su uso específico.

Métodos

create

Crea un conjunto de datos nuevo para el proyecto especificado.

delete

Borra el conjunto de datos especificado.

get

Obtiene el conjunto de datos.

list

Muestra una lista de todos los conjuntos de datos del proyecto especificado.

patch

Actualiza los metadatos del conjunto de datos.