Hópehely csatlakozó

Információk lekérdezése a Snowflake-ből a Tulip-alkalmazásokkal való használathoz

A Snowflake csatlakozó egyszerűsíti a Snowflake adatfelhőből származó információk lekérdezését. A Snowflake SQL REST API dokumentációja itt található.

Támogatás kapcsolat

Ez a csatlakozó a Spaulding Ridge céggel együttműködve jött létre. további információkért vagy kérdésekért forduljon a Spaulding Ridge céghez a info@spauldingridge.com címen.

A csatlakozóra vonatkozó megjegyzések

A Snowflake-konnektor viszonylag könnyen képes egyes rekordok manipulálására. Egyedi widgetekre lehet szükség több adatsor lekérdezéséhez vagy a Tulip kimenetek (interaktív táblázat stb.) manipulálásához.

A Snowflake OAuth a Snowflake beépített OAuth szolgáltatását használja, és támogatja a Tulipot mint egyéni klienst. A Snowflake OAuth dokumentációja itt található. Az egyéni ügyfél konfigurációjának részletei itt találhatók.

Beállítás

Ez a szakasz a Snowflake OAuth-kiszolgálójáról származó OAuth-token konfigurálásának eljárását mutatja be a Tulip-pal mint ügyféllel való kapcsolat létrehozásához, valamint a Snowflake-konnektor beállításának lépéseit a Tulipban.

A Tulip ügyfélalkalmazásként történő regisztrálása a Snowflake-ben

1. Jelentkezzen be a Snowflake-példányába egy olyan felhasználóval, aki rendelkezik a biztonsági integrációk létrehozásához és kezeléséhez szükséges szerepkörrel/jogosultsággal (ACCOUNTADMIN).
2. Hozzon létre egy új SQL munkalapot a COMPUTE_WH raktárban.
3. Futtassa az alábbi szkriptet egy OAuth típusú biztonsági integráció létrehozásához. Ne felejtse el frissíteni az INTEGRATION_NAME, a TULIP_INSTANCE_NAME és a TIME_IN_SECONDS értékeit.

BIZTONSÁGI INTEGRÁCIÓ LÉTREHOZÁSA VAGY HELYETTESÍTÉSE <INTEGRATION_NAME>TÍPUS = OAUTHENABLED = TRUEOAUTH_CLIENT = CUSTOMOAUTH_CLIENT_TYPE = 'CONFIDENTIAL'OAUTH_REDIRECT_URI = 'https://<TULIP_INSTANCE_NAME>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Megjegyzés: A frissítési token érvényessége akár 1 nap (86400 másodperc) is lehet.

Az OAuth konfiguráció részleteinek összegyűjtése a Tulipban

1. Futtassa a következő parancsokat az imént létrehozott biztonsági integráció leírására ésDESCRIBE SECURITY INTEGRATION ;
2. Írja le az alábbi adatokat:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Futtatás:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<INTEGRATION_NAME>');

teljes mértékben capitolizálni kelle.g. nem tulip_intergation hanem TULIP_INTEGRATION

1. Írja le:OAUTH_CLIENT_SECRET

Konfigurálja a Snowflake csatlakozót

1. Jelentkezz be a Tulipba és add hozzá a Snowflake Connector-t a Tulip Library-ból ide (Web vagy Embedded).
2. Kattintson a termelési környezetbe
3. Állítsa be a következő beállításokat:

Running On: Cloud Connector HostServer cím: Az Ön Snowflake-fiókjának szerver url-je a .snowflakecomputing formátumban.comBázis elérési út: api/v2AuthenticationVálassza ki a szolgáltatás vagy a felhasználó OAuthAuthorizációs kód URL - OAUTH_AUTHORIZATION_ENDPOINT a 2. lépésből 2Access token URL - OAUTH_TOKEN_ENDPOINT a 2. lépésbőlClient ID - OAUTH_CLIENT_ID a 2. lépésbőlClient Secret - OAUTH_CLIENT_SECRET a 2. lépésbőlSelect check boxes forSend authentication headerEncode client ID during authentication.

1. Kattintson a Test gombra. A Snowflake fiókjának bejelentkezési ablakába kerül.

A felhasználónak be kell jelentkeznie. Vegye figyelembe, hogy az alapértelmezett szerepe nem lehet ACCOUNTADMIN, SECURITYADMIN vagy ORGADMIN. A felhasználók alapértelmezett szerepkörét az OAuth-hoz módosíthatja, ahogyan azt ez a Snowflake-forrás részletezi: A felhasználói hozzájárulás kezelése az OAuth-hoz.

1. A sikeres hitelesítés után megjelenik egy üzenet a beleegyezésre vonatkozóan. Kérjük, olvassa el figyelmesen, hogy megértse a végrehajtott műveletet, majd kattintson az Engedélyezés gombra.

Most már biztonságosan csatlakozhat a Snowflake-hez a Tulipból!

Használat

A csatlakozó használatának megkezdéséhez két lehetősége van:

Kezdje a csatlakozó sablonfunkcióinak testreszabásával, hogy azok megfeleljenek az Ön egyedi igényeinek.

Kövesse a Snowflake egységteszt utasításait, hogy gyakorlati bemutatót kapjon a csatlakozó használatáról olyan feladatokra, mint például: az összes tábla rekordjának lekérdezése egy Snowflake táblából a Tulipban, új rekord létrehozása, meglévő rekord frissítése és rekord törlése.

Sablonfunkciók

A könyvtárcsatlakozó a következő sablonfüggvényeket tartalmazza: Sablon: Adatbázis lekérdezéseMegnevezés: Lehetővé teszi egy vagy több SQL-kijelentés elküldését végrehajtásra.Módszer: POSEndpoint: StatementsReferencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Lekérdezés állapotának ellenőrzéseMegnevezés: Method: Lehetővé teszi egy utasítás végrehajtásának állapotának ellenőrzését: GETEndpoint: Referencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Cancel QueryDescription: Módszer: A lekérdezés leírása: Lehetővé teszi egy utasítás végrehajtásának törlését: Módszer: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelReferencia: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

További hivatkozások

Ez a Snowflake közösségi útmutató további kontextust biztosít a Snowflake integrációhoz.