REST Resource: deltasharing.v1.projects.catalogs

משאב: DeltaSharingCatalog

מייצג קטלוג של DeltaSharing.

ייצוג ב-JSON 
{
  "name": string,
  "location": string,
  "createTime": string,
  "updateTime": string,
  "serviceAccount": string,
  "refreshOptions": {
    object (RefreshOptions)
  },
  "refreshStatus": {
    object (RefreshStatus)
  },
  "federatedCatalogOptions": {
    object (FederatedCatalogOptions)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "sapConfig": {
    object (SapConfig)
  }
  // End of mutually exclusive fields.
  "encryptionConfig": {
    object (EncryptionConfig)
  }
}
שדות
name

string

מזהה. שם המשאב פורמט: projects/{project}/catalogs/{catalog}
location

string

חובה. אי אפשר לשנות. המיקום ב-GCP שצוין על ידי המשתמש לקטלוג. אי אפשר לשנות את התוכן של השדה הזה.
createTime

string (Timestamp format)

פלט בלבד. מועד היצירה של הקטלוג.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. הזמן שבו בוצע השינוי האחרון בקטלוג.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
serviceAccount

string

פלט בלבד. חשבון השירות שמשמש לרישום SAP ונוצר כתוצאה לוואי של יצירת משאב קטלוג Delta Sharing.
refreshOptions

object (RefreshOptions)

זה שינוי אופציונלי. הגדרת אפשרויות לרענון קטלוג של Delta Sharing.
refreshStatus

object (RefreshStatus)

פלט בלבד. הסטטוס של רענון הקטלוג ברקע.
federatedCatalogOptions

object (FederatedCatalogOptions)

זה שינוי אופציונלי. אפשרויות הגדרה לקטלוגים מאוחדים.
ההגדרה של הקטלוג. צריך להגדיר שדה אחד בדיוק, שקובע את סוג הקטלוג. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
sapConfig

object (SapConfig)

זה שינוי אופציונלי. הגדרות לקטלוג שמתחבר ל-SAP Business Data Cloud ‏ (BDC).
סוף השדות הבלעדיים.
encryptionConfig

object (EncryptionConfig)

זה שינוי אופציונלי. הגדרת הצפנה בהתאמה אישית (למשל, מפתחות Cloud KMS).

SapConfig

הגדרות ל-SAP Business Data Cloud ‏ (BDC).

ייצוג ב-JSON 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
שדות
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

זה שינוי אופציונלי. כדי ליצור משאב קטלוג שמתחבר ל-SAP BDC, צריך לבצע את התהליך הבא בן 3 השלבים: 1. מגדירים את SapConfig כריק. הפעולה הזו יוצרת משאב קטלוג עם חשבון שירות ב-GCP: ‏ serviceAccount. 2. במופע SAP BDC, באמצעות serviceAccount, פועלים לפי תהליך ההרשמה ויוצרים BDC Connector. תקבלו connectorEndpoint ו-invitationCode מ-SAP. 3. בעזרת השדות הנוספים האלה שסופקו על ידי SAP, מעדכנים את משאב קטלוג BigLake שנוצר קודם באמצעות SapBdcEnrollmentConfig. אחרי שמגדירים את SapBdcEnrollmentConfig, אי אפשר לשנות אותו.
sapRegion

string

זה שינוי אופציונלי. אי אפשר לשנות. האזור ב-GCP שבו יש להשתמש בממשקי SAP BDC APIs. אם המטא-נתונים של הקטלוג מאוחסנים במספר אזורים (לדוגמה, us), אבל מופע SAP BDC הפיזי נמצא באזור יחיד (לדוגמה, us-central1), צריך להגדיר את השדה הזה באופן מפורש כך שיצביע על האזור היחיד הזה. אם לא מגדירים את המיקום, המערכת משתמשת במיקום שצוין במהלך יצירת הקטלוג כברירת מחדל.

SapBdcEnrollmentConfig

הקובץ מכיל את הגדרות ההרשמה שהתקבלו מ-SAP.

ייצוג ב-JSON 
{
  "connectorEndpoint": string,
  "invitationCode": string,
  "invitationUrl": string,
  "federatedIdentityIssuer": string
}
שדות
connectorEndpoint

string

זה שינוי אופציונלי. נקודת הקצה הייחודית של SAP BDC Connector.
invitationCode

string

זה שינוי אופציונלי. קוד הזמנה מ-SAP.
invitationUrl

string

זה שינוי אופציונלי. כתובת ה-URL המשולבת להזמנה שמכילה גם את נקודת הקצה וגם את הקוד.
federatedIdentityIssuer

string

פלט בלבד. ‫Lakehouse תומך בשיתוף של מוצרי נתונים עם SAP BDC. כשהשיתוף מופעל, SAP BDC ניגש למשאבים הבסיסיים באמצעות זהות מאוחדת. בשדה הזה מצוין המנפיק של הזהות המאוחדת.

במילים אחרות, צריך ליצור את מאגר הזהויות ואת ספק הזהויות באופן הבא:

‪$ gcloud iam workload-identity-pools create sap-bdc-pool \ --location="global" \ --display-name="SAP BDC Pool"

‪$ gcloud iam workload-identity-pools providers create-oidc sap-bdc-provider \ --location="global" \ --workload-identity-pool="sap-bdc-pool" \ --issuer-uri=""

לאחר מכן, צריך להוסיף את המאגר למדיניות ה-IAM של המשאבים המשותפים כדי ש-SAP BDC יוכל לגשת אליהם:

‪$ gcloud projects add-iam-policy-binding PROJECT_ID \ --role="roles/biglake.viewer" \ --member="principal://iam.googleapis.com/projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/sap-bdc-pool/subject/{TENANT_UUID}"

‫… where the TENANT_UUID can be found in the SAP BDC instance.

RefreshOptions

הגדרת אפשרויות לרענון קטלוג של Delta Sharing.

ייצוג ב-JSON 
{
  "refreshSchedule": {
    object (RefreshSchedule)
  }
}
שדות
refreshSchedule

object (RefreshSchedule)

זה שינוי אופציונלי. ההגדרה הזו קובעת אם לתזמן רענון של המטא-נתונים ומתי.

RefreshSchedule

ההגדרה הזו קובעת אם לתזמן רענון של המטא-נתונים ומתי.

ייצוג ב-JSON 
{
  "refreshInterval": string
}
שדות
refreshInterval

string (Duration format)

זה שינוי אופציונלי. המרווח לרענון מטא-נתונים מהקטלוג המרוחק. אם לא מגדירים את המדיניות, אבל רוצים לרענן את הדף, המערכת תשתמש בברירת המחדל.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-s. דוגמה: "3.5s".

RefreshStatus

סטטוס רענון ברקע של קטלוג מרוחק.

ייצוג ב-JSON 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
שדות
startTime

string (Timestamp format)

פלט בלבד. כשהרענון של הקטלוג התחיל, כולל רענונים שנמצאים בתהליך.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
status

object (Status)

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

FederatedCatalogOptions

אפשרויות ההגדרה של קטלוג מאוחד.

ייצוג ב-JSON 
{
  "serviceDirectoryName": string,
  "crossCloudCacheOptions": {
    object (CrossCloudCacheOptions)
  }
}
שדות
serviceDirectoryName

string

זה שינוי אופציונלי. שם המשאב של ספריית השירותים לניתוב תנועה דרך חיבור לרשת פרטית באמצעות Cross-Cloud Interconnect, בפורמט projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}.
crossCloudCacheOptions

object (CrossCloudCacheOptions)

זה שינוי אופציונלי. אפשרויות הגדרה של שמירת נתונים וקובצי מטא-נתונים במטמון חוצה-עננים (cross-cloud).

CrossCloudCacheOptions

אפשרויות הגדרה של שמירת נתונים וקובצי מטא-נתונים במטמון חוצה-עננים (cross-cloud).

ייצוג ב-JSON 
{
  "enabled": boolean
}
שדות
enabled

boolean

זה שינוי אופציונלי. קובעת אם מופעלת שמירת נתונים וקבצי מטא-נתונים במטמון חוצה-עננים (cross-cloud). הבעיה הזו משפיעה רק על שאילתות דרך BigQuery.

אם הערך הזה הוא true, נתוני קריאה ומטא-נתונים מאוחסנים במטמון, מה שיכול לשפר את הביצועים ולהפחית את עלויות התעבורה היוצאת (egress) ברשת עבור שאילתות חוצות-ענן.

אם הערך הוא false, שמירה במטמון חוצה-עננים מושבתת.

EncryptionConfig

הגדרת הצפנה בהתאמה אישית (למשל, מפתחות Cloud KMS).

ייצוג ב-JSON 
{
  "kmsKeyName": string
}
שדות
kmsKeyName

string

זה שינוי אופציונלי. שם מפתח Cloud KMS שמשמש להצפנת נתונים במטמון שאוחזרו מהקטלוג. פורמט: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}

Methods

create

 יוצר קטלוג חדש של DeltaSharing.

delete

 מוחק קטלוג DeltaSharing קיים שצוין לפי שם המשאב.

get

 מקבל את הקטלוג שצוין לפי שם המשאב.

list

 הצגת רשימה של כל קטלוגי DeltaSharing בפרויקט שצוין.

patch

 עדכון של קטלוג DeltaSharing קיים.