הצגת פרטים של מאגר סכימות

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

אי אפשר להשתמש בממשקי הלקוח של Apache Kafka בקוד פתוח כדי להציג את הפרטים הספציפיים של משאב מאגר הסכימות של השירות המנוהל ל-Apache Kafka.

תפקידים והרשאות נדרשים

כדי לקבל את ההרשאות שנדרשות לצפייה במאגר סכימות, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) במופע של מאגר הסכימות. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

ההרשאות הנדרשות

כדי להציג מאגר סכימות, נדרשות ההרשאות הבאות:

• צריך להעניק את ההרשאה הזו למשאב של מאגר הסכימות: managedkafka.schemaRegistries.get

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

הצגת פרטים של מאגר סכימות

כדי לאחזר את ההגדרה והפרטים של מאגר סכימות ספציפי, פועלים לפי השלבים הבאים:

המסוף

1. נכנסים לדף Schema registries במסוף Google Cloud .

   מעבר למרשמי סכימות

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

2. לוחצים על השם של מאגר הסכימות שרוצים לראות את הפרטים שלו.

   נפתח הדף Schema registry details. המידע שמוצג בדף הזה מוסבר בקטע פרטי הדף של מאגר הסכימות.

gcloud

1. התקינו את ה-CLI של Google Cloud. אחר כך, מאתחלים את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

   gcloud init

   אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

2. כדי לאחזר את ההגדרה והפרטים של מאגר סכימות ספציפי, מריצים את הפקודה gcloud beta managed-kafka schema-registries describe:

gcloud beta managed-kafka schema-registries describe SCHEMA_REGISTRY_ID \
    --location=LOCATION \

מחליפים את מה שכתוב בשדות הבאים:

• ‫SCHEMA_REGISTRY_ID (חובה): המזהה של מאגר הסכימות שרוצים לתאר.
• ‫LOCATION (חובה): ה Google Cloud אזור שבו נמצא מאגר הסכימות.

לדוגמה, הפקודה הבאה מקבלת את הפרטים של מאגר סכימות בשם test_SR שנמצא באזור us-central1:

gcloud beta managed-kafka schema-registries describe test_SR \
    --location=us-central1

הפקודה מחזירה פלט שדומה לזה:

Describing schema registry: projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR
name: projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR
mode: READWRITE
config:
  - compatibility: BACKWARD
contexts:
  - projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR/contexts/.
  - projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR/contexts/user-record

REST

• כדי לאחזר את הפרטים של מופע ספציפי של מאגר סכימות באמצעות API בארכיטקטורת REST, שולחים בקשת GET ל-URI הבא:

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID
Authorization: Bearer $(gcloud auth application-default print-access-token)

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID (חובה): מזהה הפרויקט ב- Google Cloud .
• ‫LOCATION (חובה): האזור שבו נמצא מאגר הסכימות.
• ‫SCHEMA_REGISTRY_ID (חובה): המזהה הייחודי של מאגר הסכימות שרוצים להציג.

אם הבקשה מצליחה, ה-API מחזיר קוד סטטוס 200 OK. גוף התשובה מכיל אובייקט JSON שמייצג את הפרטים של מאגר הסכימות המבוקש.

לדוגמה, התגובה הבאה היא תגובה לפקודה לקבלת הפרטים של מאגר סכימות בשם gcloud_test שנמצא באזור us-central1:

{
  "name": "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test",
  "contexts": [
    "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test/contexts/default",
    "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test/contexts/."
  ]
}

מידע נוסף מופיע במאמרי העזרה של ה-API בארכיטקטורת REST.

פרטים בדף של מאגר הסכמות

כשמציגים מאגר סכימות במסוף Google Cloud , בדף פרטי מאגר הסכימות מוצגים הפרטים הבאים לגבי המאגר שנבחר:

• ‫Region: Google Cloud האזור שבו נמצא המאגר.
• כתובת ה-URL של מאגר הסכימות: כתובת ה-URL של נקודת הקצה של מאגר הסכימות. הפורמט הוא https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID.

  לדוגמה – https://managedkafka.googleapis.com/v1main/projects/managed-kafka-project/locations/us-central1/schemaRegistries/testschemaregistry

• מצב סכימה: מצב ההפעלה שאפשר להגדיר ברמה של מאגר הסכימות וברמה של כל נושא בנפרד. ההגדרה הזו קובעת אם אפשר לבצע שינויים.
• סוג התאימות: ההגדרה ברמת הרישום לתאימות שמוגדרת כברירת מחדל ומחייבת לגבי נושאים חדשים או גרסאות סכימה חדשות ברישום הזה (אלא אם היא מבוטלת ברמת הנושא או ההקשר). ערכים נפוצים כוללים BACKWARD,‏ FORWARD,‏ FULL או NONE.
• נושאים במרשם הסכימות הזה: רשימה של שמות נושאים שמשויכים למרשם. אם יש הקשר זמין, אפשר גם לראות את ההקשר של כל נושא.

‫Apache Kafka®‎ הוא סימן מסחרי רשום של The Apache Software Foundation או של השותפים העצמאיים שלה בארצות הברית או במדינות אחרות.