Használja ezt az útmutatót, ha Ön ChatGPT-munkaterület-admin, és a Snowflake alkalmazássablont állítja be a szervezete számára. A sablon nem az a végleges alkalmazás, amelyet a tagok használnak. Ez egy beállítási folyamat, amely munkaterület-specifikus alkalmazáspiszkozatot hoz létre, miután megadta a szükséges Snowflake-konfigurációt.
A Snowflake esetében a beállítás nagy része a Snowflake-ben történik. Létrehoz egy Snowflake által kezelt MCP-szervert, hozzáférést ad a megfelelő szerepkörnek az MCP-szerverhez és az alapjául szolgáló objektumokhoz, majd megadja a kezelt MCP-szerver URL-jét vagy annak összetevőmezőit a ChatGPT sablonbeállítási folyamatában. Miután a ChatGPT létrehozta az alkalmazáspiszkozatot, közzéteheti és ugyanúgy kezelheti, mint a többi munkaterületi alkalmazást.
Mit állít be
Egy munkaterület-specifikus Snowflake-alkalmazást hoz létre a ChatGPT-ben. Az alkalmazás egy Snowflake által kezelt MCP-szerverhez csatlakozik, amely meghatározza:
Mely műveleteket használhatja a ChatGPT; ezeket eszközöknek nevezzük.
Mely Snowflake-adatokhoz vagy -objektumokhoz férhetnek hozzá ezek az eszközök.
Melyik Snowflake-szerepkörrel kell a felhasználóknak engedélyezniük a hozzáférést.
Melyik Snowflake-adatbázis, séma és MCP-szervernév azonosítja az összekötő végpontját.
A ChatGPT csak azokat az MCP-szerver által közzétett eszközöket tudja felfedezni és használni, amelyeket a felhasználó által engedélyezett Snowflake-szerepkör megenged.
Mielőtt elkezdené
Szüksége lesz a következőkre:
ChatGPT-munkaterület-adminisztrátori vagy -tulajdonosi hozzáférés.
Olyan Snowflake-hozzáférés, amellyel MCP-szerverobjektumokat lehet létrehozni és engedélyeket lehet adni.
Az a Snowflake-adatbázis és séma, ahol az MCP-szerver lesz.
Döntés arról, hogy mit tehet a ChatGPT, például Cortex Search, Cortex Analyst, csak olvasható SQL, vagy egy adott eljárás vagy függvény használata.
Egy minimális jogosultságú Snowflake-szerepkör, amelyet a felhasználók az alkalmazás engedélyezésekor használnak.
A Snowflake-fiók gazdagépelőtagja, beleértve az esetleges régió- vagy felhőutótagot.
Előkészítendő értékek
Snowflake gazdagépelőtag: minden, ami a Snowflake-fiók URL-jében a .snowflakecomputing.com előtt áll.
Adatbázis: az MCP-szervert tartalmazó adatbázis.
Séma: az MCP-szervert tartalmazó séma.
MCP-szerver neve: a Snowflake MCP-szerverobjektum neve.
A teljes kezelt MCP-szerver URL-je, ha a ChatGPT beállítási képernyője URL-t kér.
Snowflake-szerepkör: az a szerepkör, amelyet a felhasználóknak az alkalmazás engedélyezésekor használniuk kell.
Eszközlista: azok a Snowflake-objektumok és -műveletek, amelyeket a ChatGPT-vel használni szeretne.
Döntse el, mit tehet a ChatGPT
Csak azokat a képességeket válassza ki, amelyeket elérhetővé szeretne tenni. Gyakori lehetőségek:
Keresés a Cortex Search segítségével válaszok kereséséhez indexelt Snowflake-adatokban vagy -tartalmakban.
Kérdések és válaszok a Cortex Analysttel egy jóváhagyott szemantikai nézeten keresztül.
Csak olvasható SQL a kontrollált lekérdezési hozzáféréshez.
Snowflake Agent, tárolt eljárás vagy UDF adott munkafolyamatokhoz.
Ha engedélyezi az SQL-t, tartsa csak olvashatóként, kivéve, ha a szervezete átvizsgálta és jóváhagyta az írási hozzáférést.
A Snowflake MCP-szerver létrehozása
A Snowflake-ben jelentkezzen be olyan szerepkörrel, amely létrehozhatja az MCP-szervert és hozzáférést adhat. Nyisson meg egy munkalapot abban az adatbázisban és sémában, ahol az MCP-szervert létre kell hozni.
Hozzon létre egy MCP-szervert, amely csak azokat az eszközöket sorolja fel, amelyeket a ChatGPT-nek használnia kell. Cserélje le az objektumneveket a saját Snowflake-adatbázisára, sémájára, szolgáltatásaira, nézeteire, warehouse-ára és szervernevére.
Példa:
CREATE MCP SERVER CHATGPT_SNOWFLAKE_MCP FROM SPECIFICATION $$ tools: - name: "support-search" type: "CORTEX_SEARCH_SERVICE_QUERY" identifier: "CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE" title: "Support Search" description: "Search support content for relevant customer issues." - name: "sql-readonly" type: "SYSTEM_EXECUTE_SQL" title: "Read-only SQL" description: "Run read-only SQL queries against approved Snowflake data." config: read_only: true query_timeout: 600 warehouse: "CHATGPT_WH" $$;
Az eszköznevek legyenek stabilak és leíróak, hogy a ChatGPT ki tudja választani a megfelelő eszközt. Az MCP-szerver létrehozása nem ad automatikusan hozzáférést az alapjául szolgáló Snowflake-objektumokhoz.
Adja meg a megfelelő Snowflake-engedélyeket
Válassza ki azt a Snowflake-szerepkört, amellyel a felhasználók engedélyezni fognak, majd adjon hozzáférést ennek a szerepkörnek az adatbázishoz, a sémához, az MCP-szerverhez és az eszközök által használt minden alapul szolgáló objektumhoz.
Példa:
GRANT USAGE ON DATABASE CHATGPT_APPS TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON SCHEMA CHATGPT_APPS.TOOLS TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON CORTEX SEARCH SERVICE CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE TO ROLE CHATGPT_CONNECTOR_ROLE;GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;
Ha az MCP-szerver szemantikai nézetet, UDF-et, tárolt eljárást vagy Cortex Agentet tesz elérhetővé, adja meg a szükséges engedélyeket ezekhez az objektumokhoz is.
Ellenőrizze, hogy a Snowflake készen áll-e
Futtassa:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Ezután futtassa:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Erősítse meg:
A szerver a várt adatbázisban és sémában létezik.
Az eszközlista megfelel a szándékainak.
Minden eszközazonosító a megfelelő Snowflake-objektumra mutat.
A csatlakozó szerepkör rendelkezik USAGE jogosultsággal az MCP-szerveren.
A csatlakozó szerepkör rendelkezik a szükséges engedélyekkel minden alapul szolgáló objektumon.
A sablon beállításának elindítása a ChatGPT-ben
A ChatGPT-ben váltson arra a munkaterületre, ahol az alkalmazásnak elérhetőnek kell lennie.
Nyissa meg a Munkaterület beállításai > Alkalmazások menüpontot.
Válassza a Könyvtár lehetőséget.
Keressen rá a Snowflake-re.
Válassza ki a Snowflake alkalmazássablont, és indítsa el a beállítást.
Adjon meg egy egyértelmű alkalmazásnevet és leírást, például Snowflake vagy Snowflake - Analytics.
Adja meg a beállítási folyamat által kért kezelt MCP-szerveradatokat.
Ha a beállítási képernyő a teljes kezelt MCP-szerver URL-jét kéri, használja ezt a formátumot:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Ha a beállítási képernyő külön mezőket kér, ugyanazokat az értékeket használja ebből az URL-ből:
Snowflake gazdagépelőtag.
Adatbázis.
Séma.
MCP-szerver neve.
Az alkalmazáspiszkozat létrehozása és közzététele
Mentse a Snowflake-sablon beállítását a ChatGPT-ben.
Hozza létre az alkalmazáspiszkozatot.
Tekintse át az alkalmazáspiszkozat részleteit, hitelesítési beállításait és elérhető műveleteit.
Tegye közzé az alkalmazáspiszkozatot, amikor készen áll.
Ellenőrizze, hogy az alkalmazás megjelenik-e a Munkaterület beállításai > Alkalmazások > Engedélyezve helyen.
Konfigurálja a Felhasználói hozzáférés beállítást azokhoz a szerepkörökhöz, amelyeknek használniuk kell.
Tekintse át a Műveletvezérlés beállítást a közzétett eszközökhöz.
Tekintse át az Alkalmazásengedélyek beállítást annak kiválasztásához, hogy a ChatGPT mikor kérdezze meg a tagokat az alkalmazás használata előtt.
Ezek az alkalmazásengedélyek a ChatGPT-beszélgetésekre vonatkoznak. A munkaterületi ügynökök az ügynök készítője által beállított ügynökönkénti vezérlőket használják annak meghatározására, hogy mely alkalmazásműveletek érhetők el, és mikor kell a végfelhasználóktól jóváhagyást kérni. Az ügynökök viselkedéséről lásd: ChatGPT Workspace Agents for Enterprise and Business.
Az alkalmazás tesztelése
Indítsa el a csatlakozási folyamatot a ChatGPT-ből engedélyezett tesztfelhasználóként.
Jelentkezzen be a Snowflake-be, és ha a rendszer kéri, válassza ki a kívánt szerepkört.
Ellenőrizze, hogy a ChatGPT megtalálja-e a várt eszközöket az MCP-szerverről.
Először futtasson egy alacsony kockázatú olvasási műveletet, például keresést vagy csak olvasható lekérdezést jóváhagyott adatokon.
Ellenőrizze, hogy a Snowflake-engedélyek megakadályozzák a hozzáférést a jóváhagyott szerepkörön és objektumokon kívül.
MCP-szerver URL-je és OAuth-viselkedés
A ChatGPT a teljes Snowflake által kezelt MCP-szerver URL-jéhez csatlakozik. A ChatGPT az adott URL-ből származó Snowflake gazdagépelőtagot használja a Snowflake OAuth-végpontok feloldásához.
Ne illesszen be Snowsight URL-t, önmagában a Snowflake-fiók gyökér-URL-jét, vagy olyan URL-t, amely további útvonalszegmenseket tartalmaz. Az MCP URL-nek tartalmaznia kell az adatbázis, a séma és az MCP-szerver útvonalát, és pontosan meg kell egyeznie a Snowflake-objektumokkal.
Hibaelhárítás
Az MCP-szerver nem található: ellenőrizze újra a teljes MCP-szerver URL-jét, vagy a külön gazdagépelőtag-, adatbázis-, séma- és szervermezőket.
Nem jelennek meg eszközök a ChatGPT-ben: ellenőrizze, hogy az MCP-szerver specifikációja tartalmaz-e eszközöket, és hogy a szerepkör rendelkezik-e USAGE jogosultsággal az MCP-szerveren.
Egy eszköz megjelenik, de használatkor hibát jelez: ellenőrizze, hogy a szerepkör rendelkezik-e a megfelelő engedéllyel az alapul szolgáló Snowflake-objektumon.
Az SQL-eszköz hibát jelez: ellenőrizze, hogy a warehouse neve helyes-e, a warehouse elérhető-e, a szerepkör rendelkezik-e rajta USAGE jogosultsággal, és hogy a read_only true-e, ha csak olvasható hozzáférést szánt.
Az engedélyezés sikertelen: ellenőrizze, hogy a felhasználó be tud-e jelentkezni a Snowflake-be, és használhatja-e a kívánt szerepkört.
Gazdagépnév-kapcsolódási probléma: használja a megfelelő Snowflake gazdagépelőtagot. Az aláhúzásjelet tartalmazó Snowflake-gazdagépnevek problémákat okozhatnak; részesítse előnyben a kötőjeleket.