למידע מקיף יותר על תחביר של שאילתות SQL ב-Spanner, אפשר לעיין במאמר תחביר של שאילתות ב-GoogleSQL.
כללי סימון של תחביר SQL
בטבלה הבאה מפורטים כללי הסימון של התחביר שבהם משתמשים בדרך כלל במסמכי Spanner.
| סימון | דוגמה | תיאור |
|---|---|---|
| סוגריים מרובעים | [ ] |
מציין שהסעיף או הארגומנט שמופיעים בסוגריים הם אופציונליים. אל תכללו את הסוגריים האלה בשאילתת ה-SQL. |
| סוגריים | ( ) |
סוגריים מילוליים. צריך לכלול את הסוגריים בשאילתת ה-SQL. |
| קו אנכי | | |
מציין שצריך לבחור רק אפשרות אחת מבין החלופות שמופרדות באמצעות קווים אנכיים. אל תכללו קווים אנכיים בשאילתת ה-SQL. |
| סוגריים מסולסלים | { } |
מציין שהפריטים שמוקפים בתג מייצגים קבוצה של אפשרויות. צריך לבחור בדיוק אחת מהאפשרויות, שמסומנות באמצעות קווים אנכיים (לדוגמה, ב-{ a | b | c }, צריך לבחור באפשרות a, b או c).
אל תכללו את הסוגריים המסולסלים בשאילתת ה-SQL.
|
| Ellipsis | ... |
מציין שרשימה או חלק מהתחביר נחתכו כדי להיות קצרים יותר. זה שונה מפסיק שאחריו שלוש נקודות, שמציין רשימה חוזרת. אל תכללו את סימן הנקודות ('…') בשאילתה. |
| פסיק | , |
מציין פסיק מילולי, שמשמש בדרך כלל להפרדה בין פריטים ברשימה. כוללים פסיקים בשאילתה. |
| פסיק ואחריו שלוש נקודות | , ... |
מציין שאפשר לחזור על הרכיב הקודם כמה פעמים, וכל מופע מופרד באמצעות פסיק. אל תכללו את סימן הנקודות ('…') בשאילתה. צריך לכלול את הפסיקים כדי להפריד בין הרכיבים החוזרים. |
| רשימת פריטים | item [, ...] |
מציין שצריך לכלול לפחות פריט אחד. אפשר גם לכלול עוד פריטים, מופרדים בפסיקים. אל תכללו את הסוגריים או את סימן הנקודות (...) בשאילתה. צריך לכלול את הפסיקים כדי להפריד בין הפריטים הנוספים. |
[item, ...] |
מציין שאפשר לכלול לפחות פריט אחד. אפשר גם לכלול עוד פריטים, מופרדים בפסיקים. אל תכללו את הסוגריים או את סימן הנקודות (...) בשאילתה. צריך להוסיף פסיקים כדי להפריד בין הפריטים הנוספים. | |
| גרשיים | '' |
מציין סימן גרש בודד. משמש להגדרת מחרוזות מילוליות בשאילתה. כוללים את המירכאות הבודדות בשאילתה. |
| מירכאות כפולות או גרש הפוך | "" או `` |
מציין מירכאות כפולות או גרשיים הפוכים. משמש להוספת מזהים עם מרכאות בשאילתה. כוללים את סימני המירכאות הכפולות או את סימני הגרש ההפוך בשאילתה. |
| סוגריים זוויתיים | < > |
סוגריים זוויתיים מילוליים. צריך לכלול את הסוגריים הזוויתיים בשאילתת ה-SQL. |