REST Resource: projects.datasets

Ressource: Dataset

Darstellung einer Dataset-Ressource.

JSON-Darstellung
{
  "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.
}
Felder
name

string

Ressourcenname. Format: projects/{project}/datasets/{datasetId}

displayName

string

Für Menschen lesbarer Name, der in der Konsolen-UI angezeigt wird.

Darf innerhalb eines Projekts nur einmal vorkommen.

description

string

Eine Beschreibung dieses Datasets.

versionId

string

Die Versions-ID des Datasets.

usage[]

enum (Usage)

Angegebener Anwendungsfall für dieses Dataset.

status

object (Status)

Nur Ausgabe. Der Status dieser Dataset-Version.

createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem das Dataset zum ersten Mal erstellt wurde.

updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem die Dataset-Metadaten zuletzt aktualisiert wurden.

versionCreateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt der Erstellung dieser Version.

versionDescription

string

Nur Ausgabe. Die Beschreibung dieser Version des Datasets. Sie wird beim Importieren von Daten in das Dataset bereitgestellt.

Union-Feld data_source. Details zur Quelle der Daten für das Dataset. Für data_source ist nur einer der folgenden Werte zulässig:
localFileSource

object (LocalFileSource)

Eine lokale Dateiquelle für das Dataset für einen einzelnen Upload.

gcsSource

object (GcsSource)

Eine Google Cloud Storage-Dateiquelle für das Dataset bei einem einzelnen Upload.

Nutzung

Die Nutzung gibt an, wo die Daten verwendet werden sollen, um zu bestimmen, wie die Daten verarbeitet werden sollen.

Enums
USAGE_UNSPECIFIED Die Nutzung dieses Datasets ist nicht festgelegt.
USAGE_DATA_DRIVEN_STYLING Dieses Dataset wird für datengestützte Stile verwendet.

LocalFileSource

Die Details zur Datenquelle, wenn es sich um eine lokale Datei handelt.

JSON-Darstellung
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Felder
filename

string

Der Dateiname der hochgeladenen Datei.

fileFormat

enum (FileFormat)

Das Format der Datei, die hochgeladen wird.

FileFormat

Das Format der Datei, die hochgeladen wird.

Enums
FILE_FORMAT_UNSPECIFIED Nicht angegebenes Dateiformat.
FILE_FORMAT_GEOJSON GeoJson-Datei.
FILE_FORMAT_KML KML-Datei.
FILE_FORMAT_CSV CSV-Datei herunterladen" klickst.

GcsSource

Die Details zur Datenquelle, wenn sie sich in Google Cloud Storage befindet.

JSON-Darstellung
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Felder
inputUri

string

Quelldaten-URI. Beispiel: gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

Das Dateiformat des Google Cloud Storage-Objekts. Sie wird hauptsächlich zur Validierung verwendet.

Status

Status des Datasets.

JSON-Darstellung
{
  "state": enum (State),
  "errorMessage": string
}
Felder
state

enum (State)

Status-Enum für Status.

errorMessage

string

Fehlermeldung, die den Grund für den Fehler angibt. Es ist leer, wenn die Datasets nicht den Status „Fehlgeschlagen“ haben.

Status

Eine Liste der Status für das Dataset.

Enums
STATE_UNSPECIFIED Der Status dieses Datasets ist nicht festgelegt.
STATE_IMPORTING Daten werden in ein Dataset importiert.
STATE_IMPORT_SUCCEEDED Daten wurden in ein Dataset importiert.
STATE_IMPORT_FAILED Daten konnten nicht in ein Dataset importiert werden.
STATE_DELETING Das Dataset wird gerade gelöscht.
STATE_DELETION_FAILED Der Status „Löschen“ ist fehlgeschlagen. Dieser Status bedeutet, dass das Löschen des Datasets fehlgeschlagen ist. Der Löschvorgang kann noch einmal versucht werden.
STATE_PROCESSING Daten werden verarbeitet.
STATE_PROCESSING_FAILED Der Status „Verarbeitung fehlgeschlagen“. Dieser Status bedeutet, dass die Verarbeitung fehlgeschlagen ist und möglicherweise Fehler gemeldet werden.
STATE_NEEDS_REVIEW Dieser Status wird derzeit nicht verwendet.
STATE_PUBLISHING Der Veröffentlichungsstatus. Dieser Status bedeutet, dass die Veröffentlichung läuft.
STATE_PUBLISHING_FAILED Der Status der Veröffentlichung fehlgeschlagen. Dieser Status bedeutet, dass die Veröffentlichung fehlgeschlagen ist. Sie können die Veröffentlichung wiederholen.
STATE_COMPLETED Der Status „Abgeschlossen“. Dieser Status stellt das Dataset für seine spezifische Nutzung dar.

Methoden

create

Erstellt ein neues Dataset für das angegebene Projekt.

delete

Löscht das angegebene Dataset.

fetchDatasetErrors

Ruft alle Fehler eines Datasets ab.

get

Ruft das Dataset ab.

list

Listet alle Datasets für das angegebene Projekt auf.

patch

Aktualisiert die Metadaten für das Dataset.