בחירת פרוטוקול של נקודת קצה (endpoint) ל-Dataproc Metastore

בדף הזה מוסבר איך לבחור פרוטוקול של נקודת קצה (endpoint) ל-Dataproc Metastore.

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

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

לפני שמתחילים

• מפעילים את Dataproc Metastore בפרויקט.
• הסבר על דרישות הרשת שספציפיות לפרויקט שלכם.

תפקידים נדרשים

כדי לקבל את ההרשאה שדרושה ליצירת Dataproc Metastore, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט, בהתאם לעקרון של הרשאות מינימליות:

• הענקת שליטה מלאה במשאבי Dataproc Metastore (roles/metastore.editor)
• מתן גישה מלאה לכל משאבי Dataproc Metastore, כולל ניהול מדיניות IAM (roles/metastore.admin)

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

התפקיד שמוגדר מראש מכיל את ההרשאה metastore.services.create, שנדרשת כדי ליצור Dataproc Metastore.

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

מידע נוסף על הרשאות ותפקידים ספציפיים ב-Dataproc Metastore זמין במאמר ניהול גישה ל-Dataproc באמצעות IAM.

בחירת פרוטוקול של נקודת הקצה

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

בשביל שירות חדש של Dataproc Metastore

כדי ליצור שירות Dataproc Metastore ולבחור את פרוטוקול נקודת הקצה בפעם הראשונה, פועלים לפי ההוראות הבאות:

המסוף

1. במסוף Google Cloud , פותחים את הדף Dataproc Metastore:

   פתיחת Dataproc Metastore

2. בתפריט הניווט Dataproc Metastore, לוחצים על Create (יצירה).

   ייפתח הדף Create service.

3. בקטע Endpoint protocol, בוחרים באפשרות Thrift או gRPC.

   ‫Thrift הוא פרוטוקול נקודת הקצה שנבחר מראש כברירת מחדל.

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

   טיפ: מומלץ להשתמש בפרוטוקול gRPC. פרוטוקול gRPC מספק אבטחה נוספת באמצעות ניהול זהויות והרשאות גישה (IAM). הוא תומך גם בשילובי פדרציה עם מוצרים אחרים. Google Cloud מידע נוסף על בחירת פרוטוקול נקודת קצה זמין במאמר מידע על פרוטוקולי נקודות קצה.

4. בוחרים את שאר ההגדרות של השירות לפי הצורך.

5. כדי ליצור ולהפעיל את השירות, לוחצים על Submit (שליחה).

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

‫CLI של gcloud

1. כדי לבחור פרוטוקול של נקודת קצה, מריצים את הפקודה הבאה של gcloud metastore services create:

   gcloud metastore services create SERVICE \
      --endpoint-protocol=ENDPOINT_PROTOCOL ; default="thrift"
   

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

   • ‫SERVICE_ID: השם או המזהה של שירות Dataproc Metastore.

   • ‫ENDPOINT_PROTOCOL: פרוטוקול נקודת הקצה שרוצים להשתמש בו ב-Dataproc Metastore. אפשר לציין thrift או grpc.

     ‫Thrift הוא פרוטוקול נקודת הקצה שנבחר מראש כברירת מחדל.

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

     טיפ: מומלץ להשתמש בפרוטוקול gRPC. הפרוטוקול הזה מספק אבטחה נוספת באמצעות ניהול זהויות והרשאות גישה (IAM). הוא גם תומך בשילובים של פדרציה עם מוצרים אחרים של Google Cloud Google. מידע נוסף על בחירת פרוטוקול נקודת קצה זמין במאמר מידע על נקודות קצה.

2. מוודאים שהשירות נוצר בהצלחה.

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

בשירות Dataproc Metastore קיים

כדי לעדכן את פרוטוקול נקודת הקצה של שירות Dataproc Metastore קיים, פועלים לפי ההוראות הבאות:

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

המסוף

1. במסוף Google Cloud , פותחים את הדף Dataproc Metastore:

   פתיחת Dataproc Metastore

2. בדף Dataproc Metastore, לוחצים על השירות שרוצים לעדכן.

   ייפתח הדף פרטי השירות.

3. בכרטיסייה Configuration (הגדרה), לוחצים על Edit (עריכה).

   ייפתח הדף עריכת השירות.

4. בקטע Endpoint protocol, בוחרים באפשרות gRPC.

5. כדי לעדכן את השירות, לוחצים על שליחה.

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

‫CLI של gcloud

1. כדי לעדכן את פרוטוקול נקודת הקצה, מריצים את הפקודה הבאה gcloud metastore services update:

   gcloud metastore services update SERVICE \
      --endpoint-protocol=ENDPOINT_PROTOCOL
   

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

   • ‫SERVICE: השם של שירות Dataproc Metastore.
   • ‫ENDPOINT_PROTOCOL: פרוטוקול נקודת הקצה שרוצים לעדכן בשירות Dataproc Metastore. אפשר לציין רק grpc.

2. מוודאים שהעדכון בוצע בהצלחה.

   אחרי העדכון לנקודת קצה של gRPC, צריך להעניק לשירות הרשאות IAM נוספות. מידע נוסף זמין במאמר בנושא גישה לנקודות קצה של gRPC.

איך מוצאים את ערך ה-URI של נקודת הקצה

המסוף

אפשר לראות את ה-URI של נקודת הקצה בדף Dataproc Metastore.

• בנקודות קצה של Thrift, הערך של כתובת ה-URL מתחיל ב-thrift://
• בנקודות קצה של gRPC, הערך של כתובת ה-URL מתחיל ב-https://

בתמונה הבאה מוצגת דוגמה לשירות Dataproc Metastore שהוגדר עם פרוטוקול נקודת קצה של gRPC.

‫CLI של gcloud

כדי לראות את ה-URI של נקודת הקצה, מריצים את הפקודה הבאה של gcloud metastore services describe:

gcloud metastore services describe SERVICE --format="get(endpointUri)"

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

• ‫SERVICE: השם של שירות Dataproc Metastore.

המאמרים הבאים

• גישה לנקודות קצה של gRPC
• צירוף אשכול Dataproc