REST Resource: projects.datasets

Risorsa: set di dati

Una rappresentazione di una risorsa del set di dati.

Rappresentazione 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.
}
Campi
name

string

Nome della risorsa. Formato: projects/{project}/datasets/{datasetId}

displayName

string

Nome leggibile, visualizzato nell'interfaccia utente della console.

Deve essere univoco all'interno di un progetto.

description

string

Una descrizione di questo set di dati.

versionId

string

L'ID versione del set di dati.

usage[]

enum (Usage)

Caso d'uso specificato per questo set di dati.

status

object (Status)

Solo output. Lo stato della versione di questo set di dati.

createTime

string (Timestamp format)

Solo output. Data e ora di creazione del set di dati.

updateTime

string (Timestamp format)

Solo output. Ora dell'ultimo aggiornamento dei metadati del set di dati.

versionCreateTime

string (Timestamp format)

Solo output. Data e ora di creazione della versione.

versionDescription

string

Solo output. La descrizione di questa versione del set di dati. Viene fornito durante l'importazione dei dati nel set di dati.

Campo unione data_source. Dettagli sull'origine dei dati per il set di dati. data_source può essere solo uno dei seguenti:
localFileSource

object (LocalFileSource)

Un'origine file locale per il set di dati per un singolo caricamento.

gcsSource

object (GcsSource)

Un'origine file di Google Cloud Storage per il set di dati per un singolo caricamento.

Utilizzo

L'utilizzo specifica la posizione in cui i dati vengono utilizzati per definire le modalità di elaborazione dei dati.

Enum
USAGE_UNSPECIFIED L'utilizzo di questo set di dati non è impostato.
USAGE_DATA_DRIVEN_STYLING Questo set di dati verrà utilizzato per gli stili basati sui dati.

LocalFileSource

Dettagli sull'origine dati, se si tratta di un file locale.

Rappresentazione JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Campi
filename

string

Il nome del file caricato.

fileFormat

enum (FileFormat)

Il formato del file che viene caricato.

FileFormat

Il formato del file che stai caricando.

Enum
FILE_FORMAT_UNSPECIFIED Formato file non specificato.
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML file KML.
FILE_FORMAT_CSV .CSV.

GcsSource

Dettagli sull'origine dati quando si trova in Google Cloud Storage.

Rappresentazione JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Campi
inputUri

string

URI dei dati di origine. Ad esempio, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

Il formato file dell'oggetto Google Cloud Storage. Viene utilizzato principalmente per la convalida.

Stato

Stato del set di dati.

Rappresentazione JSON
{
  "state": enum (State),
  "errorMessage": string
}
Campi
state

enum (State)

Enum dello stato.

errorMessage

string

Messaggio di errore che indica il motivo dell'errore. È vuoto se il set di dati non è in uno stato "Non riuscito".

Stato

Un elenco di stati per il set di dati.

Enum
STATE_UNSPECIFIED Lo stato di questo set di dati non è impostato.
STATE_IMPORTING È in corso l'importazione dei dati in un set di dati.
STATE_IMPORT_SUCCEEDED Importazione dei dati in un set di dati riuscita.
STATE_IMPORT_FAILED Importazione dei dati in un set di dati non riuscita.
STATE_DELETING Il set di dati è in fase di eliminazione.
STATE_DELETION_FAILED Stato di eliminazione non riuscita. Questo stato rappresenta che l'eliminazione del set di dati non è riuscita. È possibile ritentare l'eliminazione.
STATE_PROCESSING I dati sono in fase di elaborazione.
STATE_PROCESSING_FAILED Stato di elaborazione non riuscita. Questo stato indica che l'elaborazione non è riuscita e potrebbe segnalare errori.
STATE_NEEDS_REVIEW Questo stato non è attualmente utilizzato.
STATE_PUBLISHING Lo stato di pubblicazione. Questo stato indica che la pubblicazione è in corso.
STATE_PUBLISHING_FAILED Stati di pubblicazione non riuscita. Questo stato indica che la pubblicazione non è riuscita. È possibile ritentare la pubblicazione.
STATE_COMPLETED Lo stato Completato. Questo stato rappresenta il set di dati disponibile per il suo utilizzo specifico.

Metodi

create

Crea un nuovo set di dati per il progetto specificato.

delete

Elimina il set di dati specificato.

get

Recupera il set di dati.

list

Elenca tutti i set di dati per il progetto specificato.

patch

Aggiorna i metadati per il set di dati.