یہ گائیڈ اس صورت میں استعمال کریں اگر آپ ChatGPT ورک اسپیس منتظم ہیں اور اپنی تنظیم کے لیے Snowflake ایپ ٹیمپلیٹ سیٹ اپ کر رہے ہیں. ٹیمپلیٹ وہ حتمی ایپ نہیں ہے جسے اراکین استعمال کرتے ہیں. یہ ایک سیٹ اپ فلو ہے جو مطلوبہ Snowflake کنفیگریشن فراہم کرنے کے بعد ورک اسپیس کے لیے مخصوص ڈرافٹ ایپ بناتا ہے.
Snowflake کے لیے، سیٹ اپ کا زیادہ تر حصہ Snowflake میں ہوتا ہے. آپ Snowflake کے زیرِ انتظام MCP سرور بناتے ہیں، درست رول کو MCP سرور اور اس کے بنیادی آبجیکٹس تک رسائی دیتے ہیں، پھر ChatGPT ٹیمپلیٹ سیٹ اپ فلو میں زیرِ انتظام MCP سرور URL یا اس کے جزوی فیلڈز درج کرتے ہیں. ChatGPT کے ڈرافٹ ایپ بنانے کے بعد، آپ اسے شائع کر سکتے ہیں اور دیگر ورک اسپیس ایپس کی طرح اس کا نظم کر سکتے ہیں.
آپ کیا سیٹ اپ کر رہے ہیں
آپ ChatGPT میں ورک اسپیس کے لیے مخصوص Snowflake ایپ بنا رہے ہیں. ایپ Snowflake کے زیرِ انتظام MCP سرور سے جڑتی ہے جو یہ متعین کرتا ہے:
ChatGPT کون سی کارروائیاں استعمال کر سکتا ہے، جنہیں ٹولز کہا جاتا ہے.
وہ ٹولز کس Snowflake ڈیٹا یا آبجیکٹس تک رسائی حاصل کر سکتے ہیں.
صارفین کو کس Snowflake رول کے ساتھ اجازت دینی چاہیے.
کون سا Snowflake ڈیٹابیس، اسکیما، اور MCP سرور نام کنیکٹر اینڈپوائنٹ کی شناخت کرتے ہیں.
ChatGPT صرف ان ٹولز کو دریافت اور استعمال کر سکتا ہے جو MCP سرور ظاہر کرتا ہے اور جن کی اجازت صارف کے مجاز کردہ Snowflake رول سے ملتی ہے.
شروع کرنے سے پہلے
آپ کو درکار ہے:
ChatGPT ورک اسپیس منتظم یا مالک کی رسائی.
Snowflake رسائی جو MCP سرور آبجیکٹس بنا سکے اور اجازتیں دے سکے.
وہ Snowflake ڈیٹابیس اور اسکیما جہاں MCP سرور موجود ہوگا.
یہ فیصلہ کہ ChatGPT کو کیا کرنے کی اجازت ہونی چاہیے، جیسے Cortex Search، Cortex Analyst، صرف پڑھنے والا SQL، یا کوئی مخصوص پروسیجر یا فنکشن.
کم سے کم اختیار والا Snowflake رول جسے صارفین ایپ کی اجازت دیتے وقت استعمال کریں گے.
Snowflake اکاؤنٹ ہوسٹ پریفکس، جس میں کوئی بھی ریجن یا کلاؤڈ لاحقہ شامل ہو.
تیار کرنے والی قدریں
Snowflake ہوسٹ پریفکس: Snowflake اکاؤنٹ URL میں .snowflakecomputing.com سے پہلے سب کچھ.
ڈیٹابیس: وہ ڈیٹابیس جس میں MCP سرور موجود ہے.
اسکیما: وہ اسکیما جس میں MCP سرور موجود ہے.
MCP سرور نام: Snowflake MCP سرور آبجیکٹ کا نام.
مکمل زیرِ انتظام MCP سرور URL، اگر ChatGPT سیٹ اپ اسکرین URL مانگے.
Snowflake رول: وہ رول جسے صارفین ایپ کی اجازت دیتے وقت استعمال کریں.
ٹول فہرست: Snowflake آبجیکٹس اور کارروائیاں جنہیں آپ ChatGPT سے استعمال کرانا چاہتے ہیں.
فیصلہ کریں کہ ChatGPT کیا کر سکتا ہے
صرف وہ صلاحیتیں منتخب کریں جنہیں آپ ظاہر کرنا چاہتے ہیں. عام اختیارات میں شامل ہیں:
اشاریہ بند Snowflake ڈیٹا یا مواد میں جوابات تلاش کرنے کے لیے Cortex Search کے ساتھ تلاش.
منظور شدہ سیمینٹک ویو کے ذریعے Cortex Analyst کے ساتھ سوال و جواب.
کنٹرول شدہ کوئری رسائی کے لیے صرف پڑھنے والا SQL.
مخصوص ورک فلو کے لیے Snowflake ایجنٹ، اسٹورڈ پروسیجر، یا UDF.
اگر آپ SQL فعال کرتے ہیں تو اسے صرف پڑھنے والا رکھیں، جب تک آپ کی تنظیم نے لکھنے کی رسائی کا جائزہ لے کر منظوری نہ دی ہو.
Snowflake MCP سرور بنائیں
Snowflake میں، ایسے رول کے ساتھ سائن اِن کریں جو MCP سرور بنا سکے اور رسائی دے سکے. اس ڈیٹابیس اور اسکیما میں ورک شیٹ کھولیں جہاں MCP سرور بنایا جانا چاہیے.
ایک MCP سرور بنائیں جو صرف وہی ٹولز فہرست میں رکھے جنہیں ChatGPT کو استعمال کرنا چاہیے. آبجیکٹ ناموں کو اپنے Snowflake ڈیٹابیس، اسکیما، سروسز، ویوز، ویئر ہاؤس، اور سرور نام سے بدلیں.
مثال:
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" $$;
ٹول نام مستحکم اور وضاحتی ہونے چاہئیں تاکہ ChatGPT درست ٹول منتخب کر سکے. MCP سرور بنانے سے بنیادی Snowflake آبجیکٹس تک رسائی خود بخود نہیں ملتی.
درست Snowflake اجازتیں دیں
وہ Snowflake رول منتخب کریں جس کے ساتھ صارفین اجازت دیں گے، پھر اس رول کو ڈیٹابیس، اسکیما، MCP سرور، اور ٹولز کے استعمال کردہ ہر بنیادی آبجیکٹ تک رسائی دیں.
مثال:
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;
اگر MCP سرور کوئی سیمینٹک ویو، UDF، اسٹورڈ پروسیجر، یا Cortex Agent ظاہر کرتا ہے تو ان آبجیکٹس کے لیے بھی مطلوبہ اجازتیں دیں.
تصدیق کریں کہ Snowflake تیار ہے
چلائیں:
SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;
پھر چلائیں:
DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;
تصدیق کریں:
سرور متوقع ڈیٹابیس اور اسکیما میں موجود ہے.
ٹول فہرست وہی ہے جو آپ نے چاہی تھی.
ہر ٹول شناخت کنندہ درست Snowflake آبجیکٹ کی طرف اشارہ کرتا ہے.
کنیکٹنگ رول کے پاس MCP سرور پر USAGE ہے.
کنیکٹنگ رول کے پاس ہر بنیادی آبجیکٹ پر درکار اجازتیں ہیں.
ChatGPT میں ٹیمپلیٹ سیٹ اپ شروع کریں
ChatGPT میں، اس ورک اسپیس پر سوئچ کریں جہاں ایپ دستیاب ہونی چاہیے.
Workspace settings > Apps کھولیں.
Directory منتخب کریں.
Snowflake تلاش کریں.
Snowflake ایپ ٹیمپلیٹ منتخب کریں اور سیٹ اپ شروع کریں.
واضح ایپ نام اور تفصیل درج کریں، جیسے Snowflake یا Snowflake - Analytics.
سیٹ اپ فلو کی درخواست کردہ زیرِ انتظام MCP سرور تفصیلات درج کریں.
اگر سیٹ اپ اسکرین مکمل زیرِ انتظام MCP سرور URL مانگے تو یہ فارمیٹ استعمال کریں:
https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}
اگر سیٹ اپ اسکرین الگ فیلڈز مانگے تو اسی URL کی وہی قدریں استعمال کریں:
Snowflake ہوسٹ پریفکس.
ڈیٹابیس.
اسکیما.
MCP سرور نام.
ڈرافٹ ایپ بنائیں اور شائع کریں
ChatGPT میں Snowflake ٹیمپلیٹ سیٹ اپ محفوظ کریں.
ڈرافٹ ایپ بنائیں.
ڈرافٹ ایپ کی تفصیلات، توثیق کی سیٹنگز، اور دستیاب کارروائیوں کا جائزہ لیں.
تیار ہونے پر ڈرافٹ ایپ شائع کریں.
تصدیق کریں کہ ایپ Workspace settings > Apps > Enabled میں نظر آتی ہے.
ان رولز کے لیے User access کنفیگر کریں جنہیں اسے استعمال کرنا چاہیے.
ظاہر کردہ ٹولز کے لیے Action control کا جائزہ لیں.
App permissions کا جائزہ لیں تاکہ منتخب کیا جا سکے کہ ChatGPT ایپ استعمال کرنے سے پہلے اراکین سے کب پوچھے.
یہ ایپ اجازتیں ChatGPT گفتگوؤں پر لاگو ہوتی ہیں. ورک اسپیس ایجنٹس، ایجنٹ کے بلڈر کے سیٹ کردہ فی ایجنٹ کنٹرولز استعمال کرتے ہیں تاکہ طے کیا جا سکے کہ کون سی ایپ کارروائیاں دستیاب ہیں اور اختتامی صارفین سے انہیں منظور کرنے کے لیے کب پوچھا جاتا ہے. ایجنٹ کے برتاؤ کے لیے، دیکھیں: Enterprise اور Business کے لیے ChatGPT ورک اسپیس ایجنٹس.
ایپ کی جانچ کریں
ChatGPT سے اجازت یافتہ ٹیسٹ صارف کے طور پر کنیکٹ فلو شروع کریں.
Snowflake میں سائن اِن کریں اور اگر کہا جائے تو مطلوبہ رول منتخب کریں.
تصدیق کریں کہ ChatGPT MCP سرور سے متوقع ٹولز دریافت کرتا ہے.
پہلے کم خطرے والی پڑھنے کی کارروائی چلائیں، جیسے منظور شدہ ڈیٹا پر تلاش یا صرف پڑھنے والی کوئری.
تصدیق کریں کہ Snowflake اجازتیں منظور شدہ رول اور آبجیکٹس سے باہر رسائی کو روکتی ہیں.
MCP سرور URL اور OAuth برتاؤ
ChatGPT مکمل Snowflake کے زیرِ انتظام MCP سرور URL سے جڑتا ہے. ChatGPT اس URL سے Snowflake ہوسٹ پریفکس استعمال کر کے Snowflake OAuth اینڈپوائنٹس حل کرتا ہے.
Snowsight URL، اکیلا Snowflake اکاؤنٹ روٹ URL، یا اضافی پاتھ سیگمنٹس والا کوئی URL پیسٹ نہ کریں. MCP URL میں ڈیٹابیس، اسکیما، اور MCP سرور پاتھ شامل ہونا چاہیے اور اسے آپ کے Snowflake آبجیکٹس سے بالکل مماثل ہونا چاہیے.
خرابیوں کا ازالہ
MCP سرور نہیں ملا: مکمل MCP سرور URL یا الگ ہوسٹ پریفکس، ڈیٹابیس، اسکیما، اور سرور فیلڈز دوبارہ چیک کریں.
ChatGPT میں کوئی ٹولز ظاہر نہیں ہوتے: تصدیق کریں کہ MCP سرور spec میں ٹولز شامل ہیں اور رول کے پاس MCP سرور پر USAGE ہے.
کوئی ٹول ظاہر ہوتا ہے لیکن استعمال پر ناکام ہوتا ہے: تصدیق کریں کہ رول کے پاس بنیادی Snowflake آبجیکٹ پر درست اجازت ہے.
SQL ٹول ناکام ہوتا ہے: تصدیق کریں کہ ویئر ہاؤس نام درست ہے، ویئر ہاؤس دستیاب ہے، رول کے پاس اس پر USAGE ہے، اور اگر آپ صرف پڑھنے والی رسائی چاہتے تھے تو read_only true ہے.
اجازت ناکام ہوتی ہے: تصدیق کریں کہ صارف Snowflake میں سائن اِن کر سکتا ہے اور مطلوبہ رول استعمال کر سکتا ہے.
ہوسٹ نام کنکشن مسئلہ: درست Snowflake ہوسٹ پریفکس استعمال کریں. انڈر اسکورز والے Snowflake ہوسٹ نام مسائل پیدا کر سکتے ہیں؛ ہائفنز کو ترجیح دیں.
