Gamitin ang gabay na ito kung isa kang admin ng ChatGPT workspace na nagse-set up ng template ng Snowflake app para sa iyong organisasyon. Ang template ay hindi ang pinal na app na gagamitin ng mga miyembro. Isa itong daloy ng pag-set up na gumagawa ng draft app na partikular sa workspace pagkatapos mong ibigay ang kinakailangang configuration ng Snowflake.
Para sa Snowflake, karamihan ng pag-set up ay ginagawa sa Snowflake. Gumagawa ka ng MCP server na pinapamahalaan ng Snowflake, binibigyan ang tamang role ng access sa MCP server at sa mga pinagbabatayang object nito, pagkatapos ay inilalagay ang URL ng managed MCP server o ang mga component field nito sa daloy ng pag-set up ng template sa ChatGPT. Pagkatapos gawin ng ChatGPT ang draft app, maaari mo itong i-publish at pamahalaan tulad ng iba pang workspace app.
Ang iyong ise-set up
Gumagawa ka ng Snowflake app na partikular sa workspace sa ChatGPT. Kumokonekta ang app sa MCP server na pinapamahalaan ng Snowflake na tumutukoy sa:
Aling mga aksyon ang magagamit ng ChatGPT, na tinatawag na tools.
Aling data o object ng Snowflake ang maa-access ng mga tool na iyon.
Aling Snowflake role ang dapat gamitin ng mga user sa pag-authorize.
Aling database, schema, at pangalan ng MCP server sa Snowflake ang tumutukoy sa connector endpoint.
Matutuklasan at magagamit lang ng ChatGPT ang mga tool na inilalantad ng MCP server at pinapayagan ng Snowflake role na ginagamit ng user sa pag-authorize.
Bago ka magsimula
Kailangan mo ng:
Access bilang admin o owner ng ChatGPT workspace.
Access sa Snowflake na makakagawa ng mga object ng MCP server at makakapagbigay ng mga pahintulot.
Ang database at schema ng Snowflake kung saan ilalagay ang MCP server.
Desisyon tungkol sa kung ano ang dapat pahintulutang gawin ng ChatGPT, gaya ng Cortex Search, Cortex Analyst, read-only SQL, o isang partikular na procedure o function.
Isang Snowflake role na may least privilege na gagamitin ng mga user kapag ina-authorize ang app.
Ang host prefix ng Snowflake account, kasama ang anumang suffix ng rehiyon o cloud.
Mga value na ihahanda
Snowflake host prefix: lahat ng nasa unahan ng .snowflakecomputing.com sa URL ng Snowflake account.
Database: ang database na naglalaman ng MCP server.
Schema: ang schema na naglalaman ng MCP server.
Pangalan ng MCP server: ang pangalan ng object ng Snowflake MCP server.
Buong URL ng managed MCP server, kung humihingi ng URL ang screen ng pag-set up ng ChatGPT.
Snowflake role: ang role na dapat gamitin ng mga user kapag ina-authorize ang app.
Listahan ng tool: ang mga object at aksyon sa Snowflake na gusto mong gamitin ng ChatGPT.
Magpasya kung ano ang magagawa ng ChatGPT
Piliin lang ang mga kakayahang gusto mong ilantad. Kabilang sa mga karaniwang opsyon ang:
Maghanap gamit ang Cortex Search para makahanap ng mga sagot sa naka-index na data o content ng Snowflake.
Q&A gamit ang Cortex Analyst sa pamamagitan ng aprubadong semantic view.
Read-only SQL para sa kontroladong access sa query.
Isang Snowflake Agent, stored procedure, o UDF para sa mga partikular na workflow.
Kung ie-enable mo ang SQL, panatilihin itong read-only maliban kung nasuri at naaprubahan ng iyong organisasyon ang write access.
Gawin ang Snowflake MCP server
Sa Snowflake, mag-sign in gamit ang role na makakagawa ng MCP server at makakapagbigay ng access. Magbukas ng worksheet sa database at schema kung saan dapat gawin ang MCP server.
Gumawa ng MCP server na naglilista lang ng mga tool na dapat gamitin ng ChatGPT. Palitan ang mga pangalan ng object ng sarili mong database, schema, service, view, warehouse, at pangalan ng server sa Snowflake.
Halimbawa:
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" $$;
Dapat stable at naglalarawan ang mga pangalan ng tool para mapili ng ChatGPT ang tamang tool. Ang paggawa ng MCP server ay hindi awtomatikong nagbibigay ng access sa mga pinagbabatayang object ng Snowflake.
Ibigay ang mga tamang pahintulot sa Snowflake
Piliin ang Snowflake role na gagamitin ng mga user sa pag-authorize, pagkatapos ay bigyan ang role na iyon ng access sa database, schema, MCP server, at bawat pinagbabatayang object na ginagamit ng mga tool.
Halimbawa:
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;
Kung naglalantad ang MCP server ng semantic view, UDF, stored procedure, o Cortex Agent, ibigay din ang mga kinakailangang pahintulot para sa mga object na iyon.
Tiyaking handa na ang Snowflake
Patakbuhin:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
Pagkatapos ay patakbuhin:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
Kumpirmahin:
Umiiral ang server sa inaasahang database at schema.
Ang listahan ng tool ay ayon sa nilayon mo.
Tumuturo ang bawat identifier ng tool sa tamang object ng Snowflake.
May USAGE ang kumokonektang role sa MCP server.
May mga kinakailangang pahintulot ang kumokonektang role sa bawat pinagbabatayang object.
Simulan ang pag-set up ng template sa ChatGPT
Sa ChatGPT, lumipat sa workspace kung saan dapat maging available ang app.
Buksan ang Workspace settings > Apps.
Piliin ang Directory.
Hanapin ang Snowflake.
Piliin ang template ng Snowflake app at simulan ang pag-set up.
Maglagay ng malinaw na pangalan at paglalarawan ng app, gaya ng Snowflake o Snowflake - Analytics.
Ilagay ang mga detalye ng managed MCP server na hinihingi ng daloy ng pag-set up.
Kung hinihingi ng screen ng pag-set up ang buong URL ng managed MCP server, gamitin ang format na ito:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
Kung humihingi ang screen ng pag-set up ng magkakahiwalay na field, gamitin ang parehong mga value mula sa URL na iyon:
Snowflake host prefix.
Database.
Schema.
Pangalan ng MCP server.
Gawin at i-publish ang draft app
I-save ang pag-set up ng Snowflake template sa ChatGPT.
Gawin ang draft app.
Suriin ang mga detalye ng draft app, mga setting ng auth, at mga available na aksyon.
I-publish ang draft app kapag handa na.
Kumpirmahing lumalabas ang app sa Workspace settings > Apps > Enabled.
I-configure ang User access para sa mga role na dapat gumamit nito.
Suriin ang Action control para sa mga inilantad na tool.
Suriin ang App permissions para piliin kung kailan magtatanong ang ChatGPT sa mga miyembro bago gamitin ang app.
Nalalapat ang mga pahintulot ng app na ito sa mga pag-uusap sa ChatGPT. Gumagamit ang Workspace Agents ng mga kontrol sa bawat agent na itinakda ng builder ng agent upang tukuyin kung aling mga aksyon ng app ang available at kung kailan hihingan ng pag-apruba ang mga end user. Para sa gawi ng agent, tingnan ang: ChatGPT Workspace Agents para sa Enterprise at Business.
Subukan ang app
Simulan ang daloy ng pagkonekta mula sa ChatGPT bilang pinapayagang test user.
Mag-sign in sa Snowflake at piliin ang nilalayong role kung hingin.
Kumpirmahing natutuklasan ng ChatGPT ang inaasahang mga tool mula sa MCP server.
Magpatakbo muna ng mababang-panganib na read action, gaya ng search o read-only query sa aprubadong data.
Kumpirmahing pinipigilan ng mga pahintulot sa Snowflake ang access sa labas ng aprubadong role at mga object.
URL ng MCP server at gawi ng OAuth
Kumokonekta ang ChatGPT sa buong URL ng MCP server na pinapamahalaan ng Snowflake. Ginagamit ng ChatGPT ang Snowflake host prefix mula sa URL na iyon para i-resolve ang mga Snowflake OAuth endpoint.
Huwag mag-paste ng Snowsight URL, ng root URL lang ng Snowflake account, o ng anumang URL na may dagdag na path segment. Dapat kasama sa MCP URL ang database, schema, at path ng MCP server at dapat eksaktong tumugma sa iyong mga object sa Snowflake.
Pag-troubleshoot
Hindi nakita ang MCP server: muling suriin ang buong URL ng MCP server o ang magkakahiwalay na field para sa host prefix, database, schema, at server.
Walang lumalabas na tool sa ChatGPT: kumpirmahing may kasamang mga tool ang spec ng MCP server at may USAGE ang role sa MCP server.
May lumalabas na tool pero pumapalya kapag ginamit: kumpirmahing may tamang pahintulot ang role sa pinagbabatayang object ng Snowflake.
Pumapalya ang SQL tool: kumpirmahing tama ang pangalan ng warehouse, available ang warehouse, may USAGE ang role dito, at true ang read_only kung read-only access ang nilayon mo.
Pumapalya ang authorization: kumpirmahing makakapag-sign in ang user sa Snowflake at magagamit ang nilalayong role.
Isyu sa koneksyon sa hostname: gamitin ang tamang Snowflake host prefix. Maaaring magdulot ng mga isyu ang mga Snowflake hostname na may underscore; mas mainam ang mga hyphen.