Skip to main content
חבר את אפליקציית Base44 שלך ל-Snowflake כדי לתשאל נתונים, להריץ אנליטיקה ולנהל מחסני נתונים, ואז בנה לוחות בקרה ודוחות על גבי נתוני המחסן שלך.
Snowflake הוא מחבר לבוני אפליקציות. אתה מחבר אותו פעם אחת עם פרטי ה-Snowflake שלך ברמת אזור העבודה, והאפליקציה שלך מתשאלת את המחסן דרך החיבור הזה. אנשים שמשתמשים באפליקציה שלך לא מחברים את Snowflake בעצמם.
אתה צריך תוכנית Builder או גבוהה יותר כדי להשתמש במחברים באפליקציה שלך.

מה אפשר לעשות

תשאול נתוני מחסן

הרץ SQL על מחסן ה-Snowflake שלך והצג את התוצאות באפליקציה שלך.

בניית לוחות בקרה אנליטיים

הפוך שאילתות מחסן לגרפים, טבלאות ולוחות בקרה שהצוות שלך יכול לקרוא.

הפעלה לפי שינויים בנתונים

שלב את Snowflake עם מחברים אחרים, לדוגמה שלח התראה לערוץ Slack כאשר מדד יורד.
הנחיות לדוגמה לצ’אט הבינה המלאכותית

במבט מהיר

מזהה סוג
snowflake
מודל אימות
OAuth, עם פרטי גישה משלך
סוג מחבר
לבוני אפליקציות (ברמת אזור העבודה)
הגדרות חיבור
subdomain (מזהה חשבון ה-Snowflake שלך, בפורמט orgname-account_name), חובה

הגדרת OAuth ב-Snowflake

ל-Snowflake אין אפליקציית OAuth מרכזית. לקוח ה-OAuth נמצא בתוך חשבון ה-Snowflake שלך, כך שאתה יוצר אותו שם ואז נותן ל-Base44 את פרטי הגישה שלו. אין דרך לעשות זאת ב-Snowsight, לכן הרץ את ההצהרות שלמטה כ-ACCOUNTADMIN בגיליון עבודה של SQL. כשאתה מאשר את החיבור מאוחר יותר, התחבר עם משתמש רגיל שיש לו DEFAULT_ROLE ו-DEFAULT_WAREHOUSE מוגדרים. Snowflake חוסם את ACCOUNTADMIN, SECURITYADMIN ו-ORGADMIN מאישור אפליקציות חיצוניות. זו ברירת מחדל אבטחתית של Snowflake, לא הגבלה של Base44.
כדי לשנות אינטגרציה שכבר קיימת, השתמש ב-ALTER. הפקודה CREATE OR REPLACE יוצרת Client ID ו-Client Secret חדשים ומבטלת את הישנים.
כדי להגדיר OAuth ב-Snowflake:
  1. צור את אינטגרציית האבטחה של OAuth:
    אם האינטגרציה כבר קיימת ורק כתובת ה-callback צריכה עדכון, הרץ במקום זאת את הפקודה הזו, ששומרת על ה-Client ID וה-Client Secret הקיימים:
  2. קרא את ה-Client ID וה-Client Secret שלך:
    העתק כל ערך עם כפתור ההעתקה של התא במקום לסמן אותו ידנית. ה-Client ID מסתיים לעיתים קרובות ב-=, והשמטת התו הזה שוברת את החיבור. הערך OAUTH_CLIENT_SECRET_2 מופיע גם הוא בפלט כרזרבה לרוטציה, לכן השתמש בסוד הראשון.
  3. קבל את מזהה החשבון שלך:
  4. ודא שהאינטגרציה מוכנה:
    בדוק ש-ENABLED הוא true וש-OAUTH_REDIRECT_URI תואם בדיוק לכתובת ה-callback.

חיבור Snowflake

Snowflake הוא מחבר לבוני אפליקציות, לכן אתה מחבר אותו פעם אחת ברמת אזור העבודה עם פרטי המחסן שלך.
לפני שאתה מתחיל, אתה צריך:
  • אינטגרציית אבטחה של Snowflake OAuth בחשבון ה-Snowflake שלך, כך שיש לך Client ID ו-Client Secret. ראה הגדרת OAuth ב-Snowflake.
  • את מזהה החשבון של Snowflake שלך (ה-subdomain), בפורמט orgname-account_name, לדוגמה nzajreo-sp04035. לא את מאתר החשבון הישן.
  • פרטי גישה מורשים לתשאל את מסדי הנתונים שאתה רוצה להשתמש בהם.
כדי להוסיף את Snowflake מהגדרות אזור העבודה שלך:
  1. לחץ על שם אזור העבודה שלך בפינה השמאלית התחתונה.
  2. לחץ על Settings.
  3. לחץ על Connectors תחת Plugins.
  4. תחת Connectors For App Builders, מצא את Snowflake.
  5. לחץ על Add לצד המחבר.
  6. ודא שכתובת ה-callback https://connectors.base44.com/api/oauth/callback מוגדרת באינטגרציית ה-OAuth שלך ב-Snowflake.
  7. הזן Connector name כדי לזהות את המחבר הזה.
  8. הזן את ה-Client ID ואת ה-Client Secret, ולאחר מכן נקה את Additional scopes אם יש בו כבר משהו.
  9. הזן את מזהה ה-Snowflake Account שלך, בפורמט orgname-account_name.
  10. לחץ על Add Connector.
אתה יכול גם להגדיר את Snowflake מצ’אט הבינה המלאכותית באפליקציה. תאר מה אתה רוצה לבנות, וכשתתבקש, ספק את אותם פרטי מחבר. המחבר נרשם ברמת אזור העבודה והופך לזמין בכל האפליקציות באותו אזור עבודה.

היקפי הרשאות

אתה לא בוחר היקפי הרשאות של Snowflake ב-Base44. Snowflake לא חושף היקפים לבחירה. מנהל Snowflake קובע גישה בתוך Snowflake, לפי תפקידי המשתמשים.
השדה Additional scopes חייב להיות ריק כשאתה רושם את המחבר. השדה מגיע לעיתים קרובות מלא מראש, לכן נקה אותו לפני השמירה. Snowflake דוחה ערכים כמו account:read ו-session:role:select עם השגיאה The requested scope is invalid. כשהשדה ריק, Snowflake מחיל את תפקיד ברירת המחדל של החשבון שמתחבר, ו-Base44 מוסיף את היקף ה-refresh_token אוטומטית, מופיע תחת Always included.

שימוש ב-Snowflake בפונקציית צד-שרת

ברגע ש-Snowflake מחובר, פונקציות צד-שרת שלך יכולות לאחזר טוקן גישה ולתשאל את המחסן שלך. Base44 מטפל בזרימת ה-OAuth ובאחסון פרטי הגישה.
לתבנית המלאה, כולל איך לקרוא את פרטי החיבור ולבנות את הבקשה, ראה את תיעוד המפתחים:

מחברים (תיעוד מפתחים)

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

פתרון בעיות

ודא שאתה עובד באזור העבודה הנכון ושיש לך הרשאה לנהל מחברים באזור העבודה. אם אתה עדיין לא רואה את Snowflake, פנה לתמיכה.
הזן את מזהה החשבון שלך בפורמט orgname-account_name, לדוגמה nzajreo-sp04035. אל תכלול את .snowflakecomputing.com.פורמט מאתר החשבון הישן, כמו xy12345.us-east-1, לא נתמך עבור OAuth. שימוש בו נכשל עם השגיאה OAuth client integration with the given client id is not found. ההודעה מציינת את ה-Client ID, אבל שדה החשבון הוא הסיבה האמיתית.כדי למצוא את המזהה שלך, הרץ את זה בגיליון עבודה של Snowflake:
אתה יכול גם לקרוא אותו מכתובת ה-Snowsight שלך: app.snowflake.com/<org>/<account> הופך ל-<org>-<account>.
בדוק שכתובת ה-callback https://connectors.base44.com/api/oauth/callback נוספה לאינטגרציית ה-OAuth שלך ב-Snowflake. לאחר מכן ודא שה-Client ID, ה-Client Secret וה-Snowflake Account נכונים, ושלתפקיד ה-Snowflake יש גישה למסדי הנתונים שאתה מתשאל.
כתובת ה-callback הרשומה ב-Snowflake לא תואמת לזו ש-Base44 שולח. הרץ DESC SECURITY INTEGRATION BASE44_OAUTH; וודא ש-OAUTH_REDIRECT_URI הוא בדיוק https://connectors.base44.com/api/oauth/callback. Snowflake מאפשר redirect URI אחד לכל אינטגרציה ומשווה אותו תו אחר תו.
התחברת עם משתמש מנהל. Snowflake חוסם את ACCOUNTADMIN, SECURITYADMIN ו-ORGADMIN מאישור אפליקציות חיצוניות כברירת מחדל. התחבר עם משתמש רגיל במקום.

שאלות נפוצות

שאלות נפוצות על חיבור Snowflake לאפליקציה שלך.
אתה צריך הרשאה לנהל מחברים באזור העבודה.
Snowflake משתמש בכתובת callback אחת עבור כל אפליקציה באזור העבודה שלך: https://connectors.base44.com/api/oauth/callback. הוסף אותה לאינטגרציית ה-OAuth שלך ב-Snowflake. אם אתה מגדיר את המחבר מצ’אט הבינה המלאכותית, טופס ההגדרה גם מציג אותה.מחברים שהוספת לפני ש-Base44 עבר לכתובת callback יחידה עדיין משתמשים ב-https://app.base44.com/api/external-auth/callback. השאר את הכתובת הזו רשומה ב-Snowflake כל עוד המחבר משתמש בכתובות לכל אפליקציה.
הזן את מזהה החשבון שלך בפורמט orgname-account_name, לדוגמה nzajreo-sp04035. אל תכלול את .snowflakecomputing.com, ואל תשתמש בפורמט מאתר החשבון הישן כמו xy12345.us-east-1, שלא נתמך עבור OAuth.
כן. אתה יכול להתחיל מצ’אט הבינה המלאכותית באפליקציה ספציפית. אם המחבר עדיין לא מוגדר, Base44 מבקש את פרטי המחבר לפני שממשיכים.
לא. מחבר Snowflake מוגדר פעם אחת ברמת אזור העבודה וניתן להשתמש בו בכל האפליקציות באותו אזור עבודה.
דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.