חיבור Snowflake לאפליקציה שלך

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

כדי להשתמש במחברים באפליקציה, צריך מסלול Builder ומעלה.

מה אפשר לעשות

השתמש בנתוני המחסן שלך כדי לענות על שאלות ולעדכן את הצוות.

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

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

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

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

אוטומציה של תהליכי נתונים

השתמש בשאילתות Snowflake בתהליכי עבודה. למשל, שלח התראה לערוץ Slack כשמדד יורד.

הנחיות לדוגמה

שלוף נתוני מכירות ממחסן ה-Snowflake שלי והצג את התוצאות.

הרץ דוח אנליטי על נתוני לקוחות שמאוחסנים ב-Snowflake.

שלוף את רמות המלאי ממחסן הנתונים ב-Snowflake.

הרץ שאילתת SQL כדי לנתח מגמות בטבלאות ה-Snowflake שלי.

הגדרת OAuth ב-Snowflake

OAuth של Snowflake משתמש ב-security integration. צור אותו ב-Snowflake לפני שאתה רושם את המחבר ב-Base44.

קבל את כתובת ה-callback של Base44

קבל את כתובת ה-callback של Base44 מתוך רישום כתובות callback. ה-SQL שלמטה רושם אותה כ-OAUTH_REDIRECT_URI.

צור את ה-security integration של OAuth

השתמש ב-ACCOUNTADMIN או בתפקיד עם ההרשאה הגלובלית CREATE INTEGRATION. הדוגמה הזו משתמשת ב-ACCOUNTADMIN. אם אתה משתמש בתפקיד אחר, החלף את ההצהרה הראשונה.

USE ROLE ACCOUNTADMIN;

CREATE SECURITY INTEGRATION BASE44_OAUTH
  TYPE                         = OAUTH
  OAUTH_CLIENT                 = CUSTOM
  OAUTH_CLIENT_TYPE            = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI           = 'https://connectors.base44.com/api/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS   = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  ENABLED                      = TRUE;

ההגדרה הזו קובעת תוקף של 90 יום לאסימוני רענון. זה ערך ברירת המחדל והמקסימום של Snowflake.אם View redirect URIs מציג כתובות נוספות עבור חיבורים קיימים, הוסף את כולן ל-OAUTH_ALTERNATE_REDIRECT_URIS בהצהרת CREATE SECURITY INTEGRATION הזו.אם תבחר שם אחר ל-integration, השתמש בו בשאר הצהרות ה-SQL.

קבל את פרטי החיבור

קרא את ה-Client ID ואת ה-Client Secret.

SELECT
  PARSE_JSON(SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('BASE44_OAUTH')):OAUTH_CLIENT_ID::STRING     AS client_id,
  PARSE_JSON(SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('BASE44_OAUTH')):OAUTH_CLIENT_SECRET::STRING AS client_secret;

השתמש בכפתור ההעתקה של התא עבור שני הערכים. ה-Client ID מסתיים לעיתים קרובות ב-=, והשמטת התו הזה שוברת את החיבור. הפלט כולל גם את OAUTH_CLIENT_SECRET_2 כגיבוי להחלפה, לכן השתמש ב-secret הראשון.קבל את מזהה חשבון Snowflake שתזין ב-Base44.

SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME() AS account_identifier;

הכן את זהות Snowflake

השתמש בזהות Snowflake רגילה שמוגדרים לה DEFAULT_ROLE ו-DEFAULT_WAREHOUSE. התפקיד שלה צריך גישה למסדי הנתונים ולאובייקטים שהאפליקציה מתשאלת, והרשאה להשתמש במחסן.כברירת מחדל, Snowflake חוסם את ACCOUNTADMIN, SECURITYADMIN, ORGADMIN ו-GLOBALORGADMIN מלהשתמש ב-integration הזה. זו ברירת מחדל אבטחתית של Snowflake, ולא הגבלה של Base44.

כבר יש לך OAuth integration?

השתמש ב-ALTER כדי לשנות integration קיים. CREATE OR REPLACE מוחק אותו ויוצר אותו מחדש, לכן אל תשתמש בו לשינוי כתובת redirect.אם ה-integration כבר קיים ורק כתובת ה-callback צריכה עדכון, הרץ את זה במקום.

ALTER SECURITY INTEGRATION BASE44_OAUTH
  SET OAUTH_REDIRECT_URI = 'https://connectors.base44.com/api/oauth/callback';

אם View redirect URIs מציג כתובות עבור חיבורים קיימים, כלול את כל הכתובות הנוספות ב-OAUTH_ALTERNATE_REDIRECT_URIS. השאר את הכתובות החלופיות שכבר רשומות.

ALTER SECURITY INTEGRATION BASE44_OAUTH
  SET OAUTH_ALTERNATE_REDIRECT_URIS = ('<additional callback URL>');

חיבור Snowflake

חבר את Snowflake כדי שהאפליקציה תוכל לתשאל את המחסן שלך.

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

OAuth integration ב-Snowflake: צור security integration של OAuth ב-Snowflake כדי לקבל Client ID ו-Client Secret. ראה הגדרת OAuth ב-Snowflake.
מזהה חשבון Snowflake: קבל אותו באמצעות ה-SQL שבהגדרת OAuth ב-Snowflake.
גישה ל-workspace ב-Base44: רק בעלים או מנהלים של ה-workspace יכולים לרשום את המחבר ב-Base44.
גישה ל-Snowflake: כל מי שמתחבר צריך גישה למסדי הנתונים שאתה רוצה לתשאל.

כדי להוסיף את Snowflake מהדף Connectors:

לחץ על Connectors בסרגל הצד של ה-workspace.
לחץ על Add connector.
חפש את Snowflake ולחץ עליו.
הזן Connector name.
הזן את ה-Client ID ואת ה-Client Secret מה-OAuth integration ב-Snowflake.
תחת Scopes, השאר את ברירות המחדל. ראה היקפי הרשאות.
תחת Connection Configuration, הזן את מזהה ה-Snowflake Account בפורמט orgname-account_name, למשל nzajreo-sp04035. אל תשתמש ב-account locator הישן.
לחץ על Add Connector.
פתח את האפליקציה ובקש מצ’אט ה-AI להוסיף תכונה של Snowflake.
אשר את החשבון כשתתבקש.

האפליקציה יכולה להשתמש בחיבור Snowflake משותף אחד, או לאפשר לכל אדם לחבר את החשבון שלו. ספר לצ’אט ה-AI מה אתה מעדיף.

היקפי הרשאות

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

מה Base44 מוסיפה

refresh_token: מרענן את החיבור בלי התחברות נוספת

מה אתה מגדיר

השאר את Additional scopes ריק. Snowflake דוחה ערכים שאינם נתמכים, כמו account:read, עם השגיאה The requested scope is invalid.
אל תוסיף session:role:<role>.

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

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

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

מחבר משותף
מחבר למשתמשי אפליקציה

השתמש ב-getWorkspaceConnection(connectorId) כשהאפליקציה משתמשת בזהות Snowflake משותפת אחת.

import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const connectorId = "YOUR_CONNECTOR_ID";

  const { accessToken, connectionConfig } =
    await base44.asServiceRole.connectors.getWorkspaceConnection(connectorId);

  // Use accessToken to query Snowflake.
  return Response.json({ account: connectionConfig.subdomain });
});

השתמש ב-getCurrentAppUserConnection(connectorId) כשכל אדם מתחבר עם זהות Snowflake משלו.

import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const user = await base44.auth.me();

  if (!user) {
    return Response.json({ error: "Unauthorized" }, { status: 401 });
  }

  const connectorId = "YOUR_CONNECTOR_ID";
  const { accessToken, connectionConfig } =
    await base44.asServiceRole.connectors.getCurrentAppUserConnection(connectorId);

  // Use accessToken to query Snowflake for the signed-in person.
  return Response.json({ account: connectionConfig.subdomain });
});

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

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

פתרון בעיות

אם Snowflake לא מצליח להתחבר או להריץ שאילתות, בדוק את התפקידים, הגישה למחסן וכתובות ה-callback.

שאילתות נכשלות עם שגיאת מחסן או גישה

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

החיבור נכשל עקב אי-התאמה של redirect URI

כתובת ה-callback שרשומה ב-Snowflake לא תואמת לזו ש-Base44 שולחת. בדוק את הכתובת או הכתובות שהחיבור שלך משתמש בהן ברישום כתובות callback. חיבורים משתמשים בכתובת callback יחידה, או בכתובות נפרדות לכל מארח אפליקציה. ודא שה-integration מופעל, והשווה את כתובות ה-redirect הרשומות בו לכתובות שהחיבור שלך משתמש בהן.

DESC SECURITY INTEGRATION BASE44_OAUTH;

ודא שכל URI ש-Base44 מציגה רשום כ-OAUTH_REDIRECT_URI או ב-OAUTH_ALTERNATE_REDIRECT_URIS. Snowflake משווה כתובות redirect תו אחר תו.

החיבור נכשל כי התפקיד שלך חסום

התחברת עם תפקיד בעל הרשאות מורחבות. כברירת מחדל, Snowflake חוסם את ACCOUNTADMIN, SECURITYADMIN, ORGADMIN ו-GLOBALORGADMIN מלהשתמש ב-integration. התחבר במקום זאת עם משתמש Snowflake רגיל.

דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.

תחילת העבודה

בניית האפליקציה

אבטחת האפליקציה

קידום האפליקציה

מחברים

יומן שינויים

מה אפשר לעשות

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

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

אוטומציה של תהליכי נתונים

הגדרת OAuth ב-Snowflake

חיבור Snowflake

היקפי הרשאות

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

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

פתרון בעיות

​מה אפשר לעשות

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

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

אוטומציה של תהליכי נתונים

​הגדרת OAuth ב-Snowflake

​חיבור Snowflake

​היקפי הרשאות

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

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

​פתרון בעיות

מה אפשר לעשות

הגדרת OAuth ב-Snowflake

חיבור Snowflake

היקפי הרשאות

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

פתרון בעיות