יצירה וניהול של תצוגות עם פרמטרים

המסוף

1. במסוף Google Cloud , פותחים את רשימת מופעי Bigtable.

   פתיחת רשימת המופעים

2. בוחרים מופע מהרשימה.

3. בחלונית הניווט, לוחצים על Bigtable Studio.

4. פותחים כרטיסייה חדשה על ידי לחיצה על add תפריט כרטיסייה חדשה ואז בוחרים באפשרות עורך.

5. כותבים את שאילתת ה-SQL בעורך השאילתות. בהגדרת השאילתה צריך לקרוא לפונקציה VIEW_PARAMETERS() כדי לציין פרמטר אחד או יותר של התצוגה. לדוגמה:

   SELECT *
   FROM TABLE_ID
   WHERE STARTS_WITH(_key, CAST(VIEW_PARAMETERS('PARAM_NAME') AS BYTES))
   

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

   • ‫TABLE_ID: המזהה של טבלת המקור.
   • ‫PARAM_NAME: השם של פרמטר התצוגה, מוקף במירכאות בודדות, שיועבר כארגומנט לפונקציה VIEW_PARAMETERS(). ההגדרה הזו מציינת את שם הפרמטר, ולא את הערך שלו בזמן הריצה. אתם מספקים את ערך זמן הריצה כשאתם שולחים שאילתה לתצוגה המפורטת עם הפרמטרים.

   אם השאילתה היא SQL תקינה, תוצג ההודעה תקינה.

6. אופציונלי: כדי לעצב את הדוח בסגנון SQL, לוחצים על עיצוב.

7. לוחצים על שמירה ואז על שמירה כתצוגה לוגית.

8. בתיבת הדו-שיח שמירת התצוגה הלוגית, מזינים שם לתצוגה ולוחצים על שמירה.

   התצוגה מופיעה בחלונית Explorer, ברשימה Logical Views, עם סמל של תצוגה עם פרמטרים variable_add.

   מידע נוסף על השימוש בעורך השאילתות זמין במאמר ניהול הנתונים באמצעות Bigtable Studio.

gcloud

כדי ליצור תצוגה עם פרמטרים, משתמשים בפקודה gcloud bigtable logical-views create.

gcloud bigtable logical-views create VIEW \
  --instance=INSTANCE \
  --query="SELECT * FROM TABLE_ID WHERE STARTS_WITH(_key, CAST(VIEW_PARAMETERS('PARAM_NAME') AS BYTES))"

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

• ‫VIEW: מזהה באורך של עד 128 תווים לתצוגה החדשה עם פרמטרים. המזהה חייב להיות ייחודי בין מזהי הטבלאות ומזהי התצוגות המפורטות במופע.
• ‫INSTANCE: המזהה של המופע שבו רוצים ליצור את התצוגה עם הפרמטרים.
• ‫TABLE_ID: המזהה של טבלת המקור.
• ‫PARAM_NAME: השם של פרמטר התצוגה, מוקף במירכאות בודדות, שיועבר כארגומנט לפונקציה VIEW_PARAMETERS(). הפרמטר הזה מגדיר את שם הפרמטר, ולא את הערך שלו בזמן הריצה. אתם מספקים את ערך זמן הריצה כשאתם שולחים שאילתה לתצוגה המפורטת עם הפרמטרים.

אופציונלי:

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

המסוף

1. ב-Bigtable Studio, פותחים את עורך השאילתות ומזינים את שאילתת ה-SQL שמסננת לפי מקטע מפתח השורה:

   SELECT *
   FROM TABLE_ID
   WHERE user_id = CAST(VIEW_PARAMETERS('user_id') AS BYTES)
   

   מחליפים את TABLE_ID במזהה של טבלת המקור.

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

3. בתיבת הדו-שיח שמירת התצוגה הלוגית, מזינים שם לתצוגה ולוחצים על שמירה.

   התצוגה מופיעה בחלונית Explorer, ברשימה Logical Views, עם סמל של תצוגה פרמטרית variable_add.

gcloud

כדי ליצור תצוגה עם פרמטרים ומפתח שורה מובנה, משתמשים בפקודה gcloud bigtable logical-views create.

gcloud bigtable logical-views create VIEW \
    --instance=INSTANCE \
    --query="SELECT * FROM TABLE_ID WHERE user_id = CAST(VIEW_PARAMETERS('user_id') AS BYTES)"

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

• ‫VIEW: מזהה באורך של עד 128 תווים לתצוגה החדשה עם פרמטרים. המזהה חייב להיות ייחודי בין מזהי הטבלאות ומזהי התצוגות המפורטות במופע.
• ‫INSTANCE: המזהה של המופע שבו רוצים ליצור את התצוגה עם הפרמטרים.
• ‫TABLE_ID: המזהה של טבלת המקור.

המסוף

1. במסוף Google Cloud , פותחים את רשימת מופעי Bigtable.

   פתיחת רשימת המופעים

2. בוחרים מופע מהרשימה.

3. בחלונית הניווט, לוחצים על Bigtable Studio.

4. בחלונית Explorer, מרחיבים את Logical Views.

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

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

gcloud

כדי לראות רשימה של תצוגות לוגיות של מכונה, משתמשים בפקודה gcloud bigtable logical-views list.

gcloud bigtable logical-views list --instance=INSTANCE

מחליפים את INSTANCE במזהה המכונה.

המסוף

1. במסוף Google Cloud , פותחים את רשימת מופעי Bigtable.

   פתיחת רשימת המופעים

2. בוחרים מופע מהרשימה.

3. בחלונית הניווט, לוחצים על Bigtable Studio.

4. בחלונית Explorer, מרחיבים את Logical Views.

5. לצד התצוגה עם הפרמטרים שרוצים לשלוח לגביה שאילתה, לוחצים על התפריט more_vert View actions (פעולות בתצוגה) ואז על Query view (שאילתה בתצוגה).

   ייפתח חלונית Parameters עם שמות הפרמטרים של התצוגה המקדימה מאוכלסים מראש.

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

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

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

8. לוחצים על Save.

9. בעורך השאילתות, לוחצים על הפעלה.

   התוצאות של השאילתה יופיעו בטבלה Results.

   אם מריצים את השאילתה בלי לספק את הפרמטרים הנדרשים של התצוגה המפורטת, תוצג הודעת שגיאה בקטע התוצאות עם לחצן עריכת פרמטרים. לוחצים על Edit parameters (עריכת פרמטרים) כדי לפתוח את החלונית Parameters (פרמטרים) ומזינים את ערכי הפרמטרים החסרים.

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

Java

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

// Assumes 'purchase_history_pv' was created with the definition:
// SELECT * FROM purchases WHERE user_id = CAST(VIEW_PARAMETERS('user_id') AS BYTES)

String query = "SELECT customer_info[email], order_details[status], order_info[items] from purchase_history_pv";
PreparedStatement preparedStatement = dataClient.prepareStatement(query);
BoundStatement boundStatement = preparedStatement.bind().build();

// The user ID is now passed out-of-band in a view parameters map.
Map<String, Value> viewParameters = new HashMap<>();
viewParameters.put("user_id", Value.newBuilder().setType(stringType()).setStringValue(userId).build());

// Execute the query, passing the view parameters using a proto field in the request.
ResultSet rs = dataClient.executeQuery(
    boundStatement,
    viewParameters
);

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