REST Resource: projects.datasets

משאב: מערך נתונים

ייצוג של משאב של מערך נתונים.

ייצוג 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.
}
שדות
name

string

שם המשאב. פורמט: projects/{project}/datasets/{datasetId}

displayName

string

שם קריא (לבני אדם) שמוצג בממשק המשתמש של המסוף.

חייב להיות ייחודי בפרויקט.

description

string

תיאור של מערך הנתונים הזה.

versionId

string

מזהה הגרסה של מערך הנתונים.

usage[]

enum (Usage)

תרחיש לדוגמה שצוין למערך הנתונים הזה.

status

object (Status)

פלט בלבד. הסטטוס של הגרסה הזו של מערך הנתונים.

createTime

string (Timestamp format)

פלט בלבד. השעה שבה נוצר מערך הנתונים לראשונה.

updateTime

string (Timestamp format)

פלט בלבד. השעה שבה עודכנו לאחרונה המטא-נתונים של מערך הנתונים.

versionCreateTime

string (Timestamp format)

פלט בלבד. השעה שבה נוצרה הגרסה.

versionDescription

string

פלט בלבד. התיאור של הגרסה הזו של מערך הנתונים. הוא מתקבל כשמייבאים נתונים למערך הנתונים.

שדה איחוד data_source. פרטים על מקור הנתונים של מערך הנתונים. data_source יכול להיות רק אחת מהאפשרויות הבאות:
localFileSource

object (LocalFileSource)

מקור קובץ מקומי למערך הנתונים בהעלאה אחת.

gcsSource

object (GcsSource)

מקור קובץ של Google Cloud Storage למערך הנתונים, בהעלאה אחת.

שימוש

השימוש מציין את המיקום שבו הנתונים ישמשו כדי לקבוע את אופן עיבוד הנתונים.

טיפוסים בני מנייה (enum)
USAGE_UNSPECIFIED השימוש במערך הנתונים הזה לא הוגדר.
USAGE_DATA_DRIVEN_STYLING מערך הנתונים הזה ישמש לסגנון מבוסס-נתונים.

LocalFileSource

הפרטים של מקור הנתונים כאשר הוא קובץ מקומי.

ייצוג JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
שדות
filename

string

שם הקובץ של הקובץ שהועלה.

fileFormat

enum (FileFormat)

הפורמט של הקובץ שמעלים.

FileFormat

הפורמט של הקובץ שמעלים.

טיפוסים בני מנייה (enum)
FILE_FORMAT_UNSPECIFIED פורמט הקובץ לא צוין.
FILE_FORMAT_GEOJSON קובץ GeoJson.
FILE_FORMAT_KML קובץ KML.
FILE_FORMAT_CSV קובץ ה-CSV.

GcsSource

הפרטים של מקור הנתונים כשהוא ב-Google Cloud Storage.

ייצוג JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
שדות
inputUri

string

URI של נתוני מקור. לדוגמה, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

פורמט הקובץ של האובייקט של Google Cloud Storage. משתמשים בה בעיקר לאימות.

סטטוס

הסטטוס של מערך הנתונים.

ייצוג JSON
{
  "state": enum (State),
  "errorMessage": string
}
שדות
state

enum (State)

'טיפוסים בני מנייה (enum)' לסטטוס.

errorMessage

string

הודעת שגיאה שמציינת את הסיבה לכשל. היא ריקה אם מערכי הנתונים לא במצב 'נכשל'.

מדינה

רשימת המצבים של מערך הנתונים.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED המצב של מערך הנתונים הזה לא הוגדר.
STATE_IMPORTING מתבצע ייבוא של הנתונים למערך נתונים.
STATE_IMPORT_SUCCEEDED ייבוא הנתונים למערך נתונים הסתיים.
STATE_IMPORT_FAILED ייבוא הנתונים למערך נתונים נכשל.
STATE_DELETING מערך הנתונים נמצא בתהליך מחיקה.
STATE_DELETION_FAILED המצב של המחיקה נכשל. המצב הזה מייצג שהמחיקה של מערך הנתונים נכשלה. ניתן לנסות שוב לבצע מחיקה.
STATE_PROCESSING הנתונים עוברים עיבוד.
STATE_PROCESSING_FAILED העיבוד נכשל. המצב הזה מציין שהעיבוד נכשל ועלול לדווח על שגיאות.
STATE_NEEDS_REVIEW המצב הזה לא בשימוש כרגע.
STATE_PUBLISHING מצב הפרסום. המצב הזה מייצג שהפרסום נמצא בתהליך.
STATE_PUBLISHING_FAILED המצבים שהפרסום נכשל. המצב הזה מייצג שהפרסום נכשל. יכול להיות שיתבצע ניסיון נוסף לפרסום.
STATE_COMPLETED המצב המלא. המצב הזה מייצג את מערך הנתונים שזמין לשימוש הספציפי שלו.

שיטות

create

יצירת מערך נתונים חדש לפרויקט שצוין.

delete

מוחק את מערך הנתונים שצוין.

fetchDatasetErrors

קבלת כל השגיאות במערך נתונים.

get

קבלת מערך הנתונים.

list

רשימה של כל מערכי הנתונים בפרויקט שצוין.

patch

עדכון המטא-נתונים של מערך הנתונים.