Hópehely csatlakozó

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

Közönség

Felhívjuk figyelmét, hogy a Snowflake integráció technikai jellegű, és a megfelelő objektumok, szerepkörök és jogosultságok létrehozásához szükség lehet az Ön informatikai támogatására.

Támogatás elérhetősége

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.

Cél

A Snowflake csatlakozó racionalizálja a Snowflake adatfelhőből származó információk lekérdezésének módját. A Snowflake SQL REST API dokumentációja itt található.

A csatlakozó megjegyzései

A Snowflake csatlakozó viszonylag egyszerűen képes egyetlen rekordot manipulálni. Egyedi widgetekre lehet szükség több adatsor lekérdezéséhez vagy a Tulip kimenetek (intercative table stb.) manipulálásához.

A Snowflake OAuth a Snowflake beépített OAuth szolgáltatását használja, és támogatja a Tulip-et 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.

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

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).

Hozzon létre egy új SQL munkalapot a COMPUTE_WH raktárban.

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.

CREATE OR REPLACE SECURITY INTEGRATION <INTEGRATION_NAME> TYPE = OAUTH ENABLED = TRUE OAUTH_CLIENT = CUSTOM OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' OAUTH_REDIRECT_URI = 'https://<TULIP_INSTANCE_NAME>.tulip.co/oauth-redirect-handler' OAUTH_ISSUE_REFRESH_TOKENS = TRUE OAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Megjegyzés: a frissítési token érvényessége akár 90 nap (7776000 másodperc) is lehet.

2. lépés: Gyűjtse össze az OAuth-konfiguráció részleteit a Tulipban.

Futtassa a következő parancsokat az imént létrehozott biztonsági integráció leírására, és jegyezze fel az alábbi részleteket: OAUTH_CLIENT_ID OAUTH_REDIRECT_URI OAUTH_AUTHORIZATION_ENDPOINT OAUTH_TOKEN_ENDPOINT OAUTH_CLIENT_SECRET OAUTH_CLIENT_SECRET

DESCRIBE SECURITY INTEGRATION ; SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('');

3. lépés: A Snowflake csatlakozó konfigurálása

Jelentkezzen be a Tulipba, és adja hozzá a Snowflake Connector-t a Tulip Libraryből (Web vagy Embedded).

Kattintson a "Production & Testing & Development" gombra a kapcsolat részleteinek szerkesztéséhez az alábbiak szerint. A SNOWFLAKE_ACCOUNT_NAME-t a 2. lépésből származó OAUTH_AUTHORIZATION_ENDPOINT vagy OAUTH_TOKEN_ENDPOINT alatt találja.

Kattintson a "Teszt" és a "Mentés" gombra. A csatlakozó online lesz.

4. lépés: A Snowflake-csatlakozó hitelesítési adatainak szerkesztése

Kattintson a "Production & Testing & Development" gombra, majd a "Edit Headers" gombra.

Válassza ki a hitelesítési típusnak az "OAuth 2 (Admin)" vagy az "OAuth 2 (Operator)" típust az igényei alapján. Erről további információkat a Hogyan konfiguráljunk egy csatlakozót című cikk Hitelesítés szakaszában talál.

Szerkessze a hitelesítési mezőket a 2. lépésben megadott adatok felhasználásával: Engedélyezési kód URL = OAUTH_AUTHORIZATION_ENDPOINT Hozzáférési token URL = OAUTH_TOKEN_ENDPOINT Ügyfél azonosító = OAUTH_CLIENT_ID Ügyfél titok = OAUTH_CLIENT_SECRET.

Kattintson a "Teszt" 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.

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, és 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 Unit Test 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ése Leírás: Lehetővé teszi egy vagy több SQL utasítás elküldését végrehajtásra. Módszer: POST végpont: /api/v2/statements Hivatkozás: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements Template: Lekérdezés állapotának ellenőrzése Leírás: Lehetővé teszi egy utasítás végrehajtásának állapotának ellenőrzését. Módszer: GET Végpont: GET Endpoint: Hivatkozás: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandle Sablon: Lekérdezés törlése Leírás: Cancel Query (Lekérdezés törlése): Lehetővé teszi egy utasítás végrehajtásának törlését. Method: POST Endpoint: /api/v2/statements/{statementHandle}/cancel Hivatkozás: 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 összefüggéseket is tartalmaz a Snowflake integrációval kapcsolatban.