‫Looker API 4.0 זמין לכלל המשתמשים (GA)

אנחנו שמחים להודיע ש-Looker API 4.0 זמין לכולם ב-Looker 22.4. גרסה 4.0 של API (גרסה 4.0 GA) זמינה לכלל המשתמשים, והיא כוללת שינויים רבים שמשבשים את התאימות לאחור ושינויים נוספים, וגם מקדמת כמה נקודות קצה מגרסת בטא לגרסה יציבה. פרטים נוספים על API 4.0 זמינים בהפניית ה-API. עדכנו את ערכות ה-SDK שנתמכות על ידי Looker ואת ערכות ה-SDK שנתמכות על ידי הקהילה כדי לתמוך בנקודות הקצה של Looker API 4.0 GA. מידע נוסף זמין במאמרים מדיניות התמיכה בממשקי API ובערכות SDK וניהול גרסאות של API. בהמשך המאמר מפורטים השינויים שעלולים לשבור את התאימות, הפתרונות והתכונות החדשות שתוכלו ליהנות מהם כשמעבירים ל-API 4.0 GA.

Who should read this?

המאמר הזה מיועד למי שמשתמש ב-Looker API דרך ערכות SDK שנתמכות על ידי Looker, ערכות SDK שנתמכות על ידי הקהילה או ה-API עצמו. כדאי לקרוא את הסעיף הבא שמתאים לגרסת Looker API שבה אתם משתמשים.

משתמשי API 4.0 טרום-GA

אם אתם משתמשים ב-API 4.0, כדאי לקרוא את הקטע הזה. המאמר כולל מידע על שינויים שעלולים לשבור את התאימות לאחור ועל פתרונות זמינים למעבר ל-API 4.0 GA.

הגרסה הזמינה לכולם של API 4.0 כוללת שינוי של כל שדות מזהי הישויות מסוג integer לסוג string. לדוגמה, הפקודה GET /groups/{group_id} endpoint תחזיר את הערך id כסוג string במקום כסוג int64.

בטבלה הבאה מפורטים ההשפעה והפתרונות שרלוונטיים לשימוש בנקודת הקצה של API 4.0:

שימוש ההשלכות1 מניעה
אפליקציות לנייד של Looker התקנות מיושנות של אפליקציות Looker לנייד מפסיקות לפעול המשתמשים צריכים לעדכן לגרסה האחרונה של אפליקציות Looker לנייד
‫SDKs2 נתמכים ב-Looker
‫TypeScript SDK (גרסה 4.0 של API) אין השפעה לא נדרשת פעולה
‫Python SDK (4.0 API) אין השפעה לא נדרשת פעולה
‫Ruby SDK (4.0 API) אין השפעה לא נדרשת פעולה
ערכות SDK עם תמיכה מהקהילה2
‫Swift SDK חריגות בזמן ריצה מעדכנים את ה-SDK לגרסה 22.0 ואילך, ואז פותרים את שגיאות הטיפוס שנוצרות, אם יש כאלה.
‫Kotlin SDK אין השפעה לא נדרשת פעולה
‫LookR SDK אין השפעה לא נדרשת פעולה
‫C# SDK אין השפעה לא נדרשת פעולה
‫Go SDK חריגות בזמן ריצה מעדכנים את ה-SDK לגרסה 22.0 ואילך, ואז פותרים את שגיאות הטיפוס שנוצרות, אם יש כאלה.
אחר
שימוש ב-API בגרסה 4.0 ללא SDK (או עם ספריות שסופקו חיצונית) שגיאות אפשריות בזמן ריצה, בהתאם לרגישות לסוג של השפה בודקים את הקוד כדי לראות אם יש תלות בסוג של שדות מזהים, ומוסיפים תמיכה בשדות מזהים מסוג מחרוזת. מומלץ לעיין גם בהנחיות הנוספות האלה.

‫1: בהנחה של דפוסי שימוש נפוצים שעשויים לכלול שימוש בשדות מזהים של Looker, אבל לא דפוסי שימוש חריגים כמו הפעלת פעולות מספריות על מזהים.

‫2: Looker API & SDK support. ספריות עם תמיכה מהקהילה לא נתמכות רשמית על ידי Looker.

משתמשי API 3.1

אם אתם משתמשים ב-API 3.1, כדאי לקרוא את הקטע הזה. המאמר כולל הסבר על התכונות הנוספות והשינויים שזמינים לכם ב-API 4.0. חשוב לזכור שכל ערכות ה-SDK שלנו שנתמכות על ידי Looker ועל ידי הקהילה תומכות בעיקר ב-API 4.0. מידע נוסף זמין במאמר בנושא מדיניות התמיכה ב-SDK וב-API.

תכונות נוספות ב-API 4.0 GA

לנוחיותכם, ריכזנו כאן את השינויים החשובים והשימושיים ביותר ב-API 4.0:

שינויים בהוצאה משימוש של API 4.0 GA

גרסת API 4.0 GA מחליפה כמה נקודות קצה (endpoints) של API 3.1 שהוצאו משימוש בתכונות משופרות. נקודות הקצה הבאות מושפעות:

משתמשי API 3.0

‫API 3.0 הוצא משימוש, ומומלץ לעבור ל-API 4.0.

  • רק API 4.0 תומך בכל ערכות ה-SDK שנתמכות על ידי Looker ועל ידי הקהילה, כדי להקל על הפיתוח. כדאי לעיין במאגר ה-SDK שלנו.
  • ב-API 4.0 נוספו תכונות חדשות ושיפורים רבים, כמו שמופיע בקטע תכונות נוספות של API 4.0 GA בדף הזה.

סיכום

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