OpenAI
ეს გვერდი მანქანური თარგმანის მეშვეობით ითარგმნა. სტატიის ინგლისური დედნის ნახვა.

Snowflake აპის შაბლონის დაყენება ChatGPT-ში

გაიგეთ, როგორ შეუძლიათ ChatGPT-ის სამუშაო სივრცის ადმინისტრატორებსა და ChatGPT Plus-ის ან Pro-ს მომხმარებლებს ChatGPT-ის დაკავშირება Snowflake-ის მიერ მართულ MCP სერვერთან.

განახლებულია: 8 days ago

ეს გზამკვლევი გამოიყენეთ, თუ ხართ ChatGPT-ის სამუშაო სივრცის ადმინისტრატორი ან ChatGPT Plus-ის ან Pro-ს მომხმარებელი და გსურთ ChatGPT-ის Snowflake-თან დაკავშირება Snowflake-ის მიერ მართული MCP სერვერის მეშვეობით.

გამართვის უმეტესი ნაწილი Snowflake-ში სრულდება. როცა Snowflake მზად იქნება, ChatGPT-ში დაასრულეთ Snowflake-ის შაბლონის დაკავშირება, შემდეგ კი ჩართეთ Snowflake-ის პლაგინი, რომელიც ამ შაბლონს იყენებს.

  • ჩაშენებული OAuth: თუ ის ხელმისაწვდომია თქვენი Snowflake-ის ანგარიშისთვის და ChatGPT-ში, გამოიყენეთ ChatGPT-ის პარტნიორი აპლიკაცია, რომელიც Snowflake-ის ადმინისტრატორმა ჩართო. შედით Snowflake-ში; თუ თქვენს ორგანიზაციაში გამართულია ერთიანი ავთენტიფიკაციით შესვლა, გამოიყენეთ ის. ChatGPT-ში კლიენტის ID-ის ან კლიენტის საიდუმლო გასაღების შეყვანა არ გჭირდებათ. მიჰყევით ქვემოთ მოცემულ განყოფილებას „ჩაშენებული OAuth“.

  • მორგებული OAuth კლიენტი: გამოიყენეთ ეს გზა, თუ თქვენი ორგანიზაცია მოითხოვს საკუთარ OAuth კლიენტს ან ჩაშენებული OAuth ხელმისაწვდომი არ არის. მიჰყევით ქვემოთ მოცემულ განყოფილებას „მორგებული OAuth კლიენტი“.

OAuth-ის ორივე გზისთვის საჭიროა ქვემოთ აღწერილი საერთო ნაბიჯები: MCP სერვერის გამართვა, გამოყენებულ ობიექტებზე ნებართვების მინიჭება და ქსელური წვდომის უზრუნველყოფა. OAuth-ის გამართვამდე შეასრულეთ საერთო ნაბიჯები განყოფილების „შეიყვანეთ Snowflake-ის სერვერის დეტალები ChatGPT-ში“ ჩათვლით.

რას მართავთ

თქვენ ქმნით Snowflake-ის მიერ მართულ MCP სერვერს, რომელიც ChatGPT-ისთვის კონექტორის საბოლოო წერტილის როლს ასრულებს. MCP სერვერი განსაზღვრავს:

  • რომელი მოქმედებების გამოყენება შეუძლია ChatGPT-ს.

  • Snowflake-ის რომელ მონაცემებსა თუ ობიექტებზე აქვს წვდომა ამ ხელსაწყოებს.

  • Snowflake-ის რომელი როლით ახდენს ავტორიზაციას თითოეული მომხმარებელი.

  • Snowflake-ის რომელი მონაცემთა ბაზა, სქემა და MCP სერვერის სახელი განსაზღვრავს საბოლოო წერტილს.

შემდეგ ChatGPT-ში გამართავთ Snowflake — ოფიციალურ შაბლონს მართული MCP სერვერის სრული URL-ით. შაბლონის გამართვის ეკრანზე URL შეიძლება ოთხ ცალკე ველად იყოს ნაჩვენები:

  • Snowflake-ის ჰოსტის პრეფიქსი.

  • მონაცემთა ბაზა.

  • სქემა.

  • MCP სერვერის სახელი.

ChatGPT-ს მხოლოდ იმ ხელსაწყოების აღმოჩენა და გამოყენება შეუძლია, რომლებსაც MCP სერვერი ხელმისაწვდომს ხდის და რომელთა გამოყენებასაც უშვებს მომხმარებლის ავტორიზაციისთვის გამოყენებული Snowflake-ის როლი.

დაწყებამდე

საჭიროა:

  • ChatGPT-ის სამუშაო სივრცის ადმინისტრატორის ან მფლობელის წვდომა, ან წვდომა ChatGPT Plus-ზე ან Pro-ზე.

  • Snowflake-ზე წვდომა MCP სერვერის ობიექტების შექმნისა და ნებართვების მინიჭების უფლებით.

  • Snowflake-ის მონაცემთა ბაზა და სქემა, სადაც MCP სერვერი განთავსდება.

  • გადაწყვეტილება იმის შესახებ, თუ რისი გამოყენების უფლება უნდა ჰქონდეს ChatGPT-ს, მაგალითად: Cortex Search, Cortex Analyst, მხოლოდ წაკითხვის SQL ან კონკრეტული პროცედურა თუ ფუნქცია.

  • Snowflake-ის როლი მინიმალური საჭირო პრივილეგიებით, რომელსაც მომხმარებლები აპის ავტორიზაციისას გამოიყენებენ.

  • Snowflake-ის ანგარიშის ჰოსტის პრეფიქსი, რეგიონის ან ღრუბლოვანი პროვაიდერის ყველა სუფიქსის ჩათვლით.

თუ თქვენი Snowflake-ის ანგარიში წვდომას ქსელის პოლიტიკით ან დაშვებული IP მისამართების სიით ზღუდავს, სთხოვეთ Snowflake-ის ადმინისტრატორს, დაუშვას შემომავალი კავშირები ChatGPT-ის კონექტორების გამავალი IP მისამართების მიმდინარე დიაპაზონებიდან. სია დინამიკურია და ყოველთვის განახლებული უნდა იყოს.

მოსამზადებელი მნიშვნელობები

  • Snowflake-ის ჰოსტის პრეფიქსი: Snowflake-ის ანგარიშის URL-ში .snowflakecomputing.com-მდე არსებული ნაწილი.

  • მონაცემთა ბაზა: ბაზა, რომელშიც MCP სერვერია განთავსებული.

  • სქემა: სქემა, რომელშიც MCP სერვერია განთავსებული.

  • MCP სერვერის სახელი: Snowflake-ის MCP სერვერის ობიექტის სახელი.

  • მართული MCP სერვერის სრული URL, თუ ChatGPT-ის გამართვის ეკრანი URL-ს ითხოვს.

  • Snowflake-ის როლი: როლი, რომელიც მომხმარებლებმა აპის ავტორიზაციისას უნდა გამოიყენონ.

  • ხელსაწყოების სია: Snowflake-ის ობიექტები და მოქმედებები, რომლებიც გსურთ ChatGPT-მა გამოიყენოს.

განსაზღვრეთ, რისი გაკეთება შეეძლება ChatGPT-ს

აირჩიეთ მხოლოდ ის შესაძლებლობები, რომელთა ხელმისაწვდომობაც გსურთ. გავრცელებული ვარიანტებია:

  • ძიება Cortex Search-ით Snowflake-ის ინდექსირებულ მონაცემებსა თუ შიგთავსში პასუხების საპოვნელად.

  • კითხვა-პასუხი Cortex Analyst-ით დამტკიცებული სემანტიკური ხედის გამოყენებით.

  • მხოლოდ წაკითხვის SQL მოთხოვნების შესრულებაზე კონტროლირებადი წვდომისთვის.

  • Snowflake-ის აგენტი, შენახული პროცედურა ან UDF კონკრეტული სამუშაო პროცესისთვის.

თუ SQL-ს ჩართავთ, დატოვეთ მხოლოდ წაკითხვის რეჟიმში, თუ თქვენს ორგანიზაციას ჩაწერის წვდომა განხილული და დამტკიცებული არ აქვს.

გახსენით Snowflake-ის სამუშაო ფურცელი

  1. შედით Snowflake-ის აპში.

  2. გადაერთეთ როლზე, რომელსაც შეუძლია MCP სერვერის შექმნა და წვდომის მინიჭება.

  3. გადადით განყოფილებაში სამუშაო სივრცეები.

    Snowflake navigation menu showing Workspaces selected during MCP server setup.

  4. შექმენით სამუშაო სივრცე SQL ფაილით.

    Snowflake workspace with a SQL file open for MCP server setup.

  5. სამუშაო სივრცის კონტექსტად დააყენეთ ის მონაცემთა ბაზა და სქემა, სადაც MCP სერვერი შეიქმნება.

    Snowflake worksheet context picker showing the role, warehouse, database, and schema.

შექმენით Snowflake-ის MCP სერვერი

Snowflake-ში შედით როლით, რომელსაც შეუძლია MCP სერვერის შექმნა და წვდომის მინიჭება. გახსენით სამუშაო ფურცელი იმ მონაცემთა ბაზასა და სქემაში, სადაც MCP სერვერი უნდა შეიქმნას.

შეასრულეთ ქვემოთ მოცემული მაგალითის მსგავსი ბრძანება. ჩაანაცვლეთ სახელები თქვენი 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: "revenue-analyst"
type: "CORTEX_ANALYST_MESSAGE"
identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW"
title: "Revenue Analyst"
description: "Answer revenue questions using the approved semantic view."
- 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"
$$;

Snowflake result confirming that the MCP server was successfully created.

ამ ბრძანებაში ხელსაწყოების სახელები და Snowflake-ის ობიექტები მაგალითებად არის მოცემული:

  • support-search ხელმისაწვდომს ხდის მითითებულ Cortex Search სერვისს.

  • revenue-analyst ხელმისაწვდომს ხდის მითითებულ სემანტიკურ ხედს. საჭიროებისამებრ დაამატეთ ხელსაწყოები სხვა ხედებისთვის.

  • sql-readonly ხელმისაწვდომს ხდის მხოლოდ წაკითხვის SQL-ს მითითებული საწყობის გამოყენებით.

ხელსაწყოებს მიანიჭეთ უცვლელი, აღწერითი სახელები, რათა ChatGPT-მა სწორი ხელსაწყოს არჩევა შეძლოს. MCP სერვერის შექმნა ავტომატურად არ იძლევა წვდომას მის მიერ გამოყენებულ Snowflake-ის ობიექტებზე.

სპეციფიკაციის დამატებითი ვარიანტებისთვის იხილეთ: Snowflake-ის მიერ მართული MCP სერვერის შექმნა.

მიანიჭეთ საჭირო ნებართვები Snowflake-ში

აირჩიეთ Snowflake-ის როლი, რომლითაც მომხმარებლები ავტორიზაციას მოახდენენ, შემდეგ კი ამ როლს მიანიჭეთ წვდომა:

  1. მონაცემთა ბაზასა და სქემაზე.

  2. MCP სერვერზე.

  3. ყველა ობიექტზე, რომელსაც ხელსაწყოები იყენებს, მაგალითად, ძიების სერვისზე, სემანტიკურ ხედზე ან საწყობზე.

მაგალითი:

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 SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;

თუ MCP სერვერი ხელმისაწვდომს ხდის UDF-ს, შენახულ პროცედურას ან Cortex-ის აგენტს, ამ ობიექტზეც მიანიჭეთ საჭირო ნებართვები.

შეამოწმეთ, მზად არის თუ არა Snowflake

შეასრულეთ:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

შემდეგ შეასრულეთ:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

დარწმუნდით, რომ:

  • სერვერი არსებობს მოსალოდნელ მონაცემთა ბაზასა და სქემაში.

  • ხელსაწყოების სია თქვენს ჩანაფიქრს შეესაბამება.

  • თითოეული ხელსაწყოს identifier მიუთითებს Snowflake-ის სწორ ობიექტზე.

  • დაკავშირებისთვის გამოყენებულ როლს MCP სერვერზე USAGE ნებართვა აქვს.

  • დაკავშირებისთვის გამოყენებულ როლს ყველა გამოყენებულ ობიექტზე საჭირო ნებართვები აქვს.

შეიყვანეთ Snowflake-ის სერვერის დეტალები ChatGPT-ში

სამუშაო სივრცის გასამართად გახსენით admin.openai.com, აირჩიეთ სასურველი ChatGPT-ის სამუშაო სივრცე და გახსენით „პლაგინები“. სამუშაო სივრცეში ნავიგაციისა და ძველ აპებზე წვდომის შესახებ იხილეთ პლაგინებისა და აპების ადმინისტრაციული მართვა, უსაფრთხოება და შესაბამისობა.

  1. ChatGPT-ში გადაერთეთ იმ ანგარიშზე ან სამუშაო სივრცეზე, სადაც აპი ხელმისაწვდომი უნდა იყოს.

  2. პირადი გამოყენებისთვის გასამართად გადადით პარამეტრები > პლაგინები, ხოლო სამუშაო სივრცის გასამართად, როგორც მისი ადმინისტრატორი, გადადით ადმინისტრატორის კონსოლი > პლაგინები.

  3. მოძებნეთ Snowflake.

  4. ჩართეთ Snowflake — ოფიციალური შაბლონი.

  5. გახსენით Snowflake — ოფიციალური შაბლონი, შეიყვანეთ კავშირის გასაგები სახელი და აირჩიეთ დაკავშირება.

  6. შეიყვანეთ მართული MCP სერვერის სრული URL:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

მაგალითი:

https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

ChatGPT Snowflake Template connection form with name, managed MCP server URL, and OAuth settings.

თუ გამართვის ეკრანზე Snowflake-ის კონფიგურაცია ცალკე ველებადაა ნაჩვენები, გამოიყენეთ URL-ში მოცემული იგივე მნიშვნელობები:

Snowflake-ის ჰოსტის პრეფიქსი

გამოიყენეთ თქვენი Snowflake-ის ანგარიშის URL-ში .snowflakecomputing.com-მდე არსებული ნაწილი, რეგიონის ან ღრუბლოვანი პროვაიდერის ყველა სუფიქსის ჩათვლით.

მაგალითად, თუ ანგარიშის URL ასე იწყება:

https://myorg-myaccount.azure.snowflakecomputing.com

ჰოსტის პრეფიქსია:

myorg-myaccount.azure

მონაცემთა ბაზა

შეიყვანეთ მონაცემთა ბაზა, რომელშიც MCP სერვერია განთავსებული, მაგალითად:

CHATGPT_APPS

სქემა

შეიყვანეთ სქემა, რომელშიც MCP სერვერია განთავსებული, მაგალითად:

TOOLS

MCP სერვერის სახელი

შეიყვანეთ Snowflake-ის MCP სერვერის ობიექტის სახელი, მაგალითად:

CHATGPT_SNOWFLAKE_MCP

გამართეთ OAuth

აირჩიეთ OAuth-ის ის გზა, რომელიც ხელმისაწვდომია თქვენი ანგარიშისთვის და თქვენი ორგანიზაციის მოთხოვნებს აკმაყოფილებს. ორივე გზისთვის გამოიყენება ზემოთ მოცემული MCP სერვერის გამართვის საერთო ნაბიჯები და ქვემოთ მოცემული კავშირის ტესტები და წვდომის მართვის პარამეტრები.

OAuth-ის ნებისმიერი გზის შემთხვევაში, როცა იყენებთ session:role:all-ს, Snowflake თითოეული მომხმარებლის ნაგულისხმევ როლს იყენებს. ნაგულისხმევი როლი დაშვებული უნდა იყოს OAuth ინტეგრაციის დაშვებული როლების სიით, თუ ასეთი სია გამართულია, და არ უნდა იყოს დაბლოკილი. სხვა დამტკიცებული როლის ქონა მის ავტომატურად არჩევას არ ნიშნავს.

ჩაშენებული OAuth

გაგრძელებამდე შეასრულეთ ზემოთ მოცემული საერთო განყოფილებების ნაბიჯები: შექმენით MCP სერვერი, მიანიჭეთ ნებართვები, შეამოწმეთ სერვერი და შეიყვანეთ მისი დეტალები ChatGPT-ში. ეს აუცილებელია მაშინაც, თუ პირდაპირ ამ განყოფილებაზე გადმოხვედით.

ეს გზა მხოლოდ მაშინ გამოიყენეთ, როცა ChatGPT-ის პარტნიორი აპლიკაცია ხელმისაწვდომია თქვენი Snowflake-ის ანგარიშისთვის და ChatGPT-ის გამართვის მოდალურ ფანჯარაში ხელმისაწვდომია ჩაშენებული OAuth.

  1. სთხოვეთ Snowflake-ის ადმინისტრატორს, ჩართოს ChatGPT-ის პარტნიორი ინტეგრაცია იმავე Snowflake-ის ანგარიშში, სადაც MCP სერვერია განთავსებული. გამოიყენეთ უკვე ჩართული ChatGPT-ის პარტნიორი ინტეგრაცია.

  2. ChatGPT-ის გამართვის მოდალურ ფანჯარაში გამოიყენეთ ჩაშენებული OAuth. კლიენტის ID-ის ან კლიენტის საიდუმლო გასაღების შეყვანა თუ უკუგამოძახების URL-ის რეგისტრაცია არ გჭირდებათ.

  3. შესასვლელად, თანხმობის მისაცემად და წვდომის გასამართად გააგრძელეთ ქვემოთ მოცემული განყოფილებით „დააკავშირეთ და მართეთ Snowflake“. შემდეგ შეასრულეთ განყოფილების „გამოსცადეთ აპი“ ნაბიჯები, მათ შორის ტესტები წვდომის მქონე არაადმინისტრატორ წევრებთან.

ზემოთ აღწერილი წესები ნაგულისხმევი როლის, დაშვებული როლების სიისა და დაბლოკილი როლების შესახებ ამ გზაზეც ვრცელდება.

მორგებული OAuth კლიენტი

გაგრძელებამდე შეასრულეთ ზემოთ მოცემული საერთო განყოფილებების ნაბიჯები: შექმენით MCP სერვერი, მიანიჭეთ ნებართვები, შეამოწმეთ სერვერი და შეიყვანეთ მისი დეტალები ChatGPT-ში. ეს აუცილებელია მაშინაც, თუ პირდაპირ ამ განყოფილებაზე გადმოხვედით.

მორგებული OAuth კლიენტისთვის გჭირდებათ კლიენტის ID და კლიენტის საიდუმლო გასაღები Snowflake-იდან. ზემოთ აღწერილი წესები ნაგულისხმევი როლის, დაშვებული როლების სიისა და დაბლოკილი როლების შესახებ ამ გზაზეც ვრცელდება.

  1. ChatGPT-ის გამართვის მოდალურ ფანჯარაში აირჩიეთ OAuth-ის გაფართოებული პარამეტრები > მომხმარებლის მიერ განსაზღვრული OAuth კლიენტი და ზუსტად დააკოპირეთ ChatGPT-ში ნაჩვენები უკუგამოძახების URL.

  2. შექმენით მორგებული OAuth უსაფრთხოების ინტეგრაცია პარამეტრით OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' და OAUTH_REDIRECT_URI-ის მნიშვნელობად ზუსტად ეს უკუგამოძახების URL დააყენეთ.

  3. Snowflake-ში შეასრულეთ შემდეგი ბრძანება; ინტეგრაციის სახელი დიდი ასოებით მიუთითეთ:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

  4. მიღებული JSON-იდან ChatGPT-ში ჩასვით oauth_client_id ველში OAuth კლიენტის ID, ხოლო oauth_client_secret — ველში OAuth კლიენტის საიდუმლო გასაღები.

  5. პარამეტრისთვის ტოკენის საბოლოო წერტილის ავთენტიფიკაციის მეთოდი დააყენეთ client_secret_basic.

მორგებული კლიენტის ავტორიზაციის მონაცემების შეყვანის შემდეგ გააგრძელეთ ქვემოთ მოცემული განყოფილებებით „დააკავშირეთ და მართეთ Snowflake“ და „გამოსცადეთ აპი“.

დააკავშირეთ და მართეთ Snowflake

  1. OAuth-ის ნებისმიერი გზის შემთხვევაში, ChatGPT-ის გამართვის იმავე მოდალურ ფანჯარაში აირჩიეთ გაგრძელება, შედით Snowflake-ში და დაუშვით დაკავშირება. შეგიძლიათ გამოიყენოთ თქვენი ორგანიზაციის ერთიანი ავთენტიფიკაციით შესვლა, თუ ის გამართულია.

  2. სამუშაო სივრცის გამართვისას დააყენეთ პლაგინის ინსტალაციის პოლიტიკა და როლებზე ან ჯგუფებზე დაფუძნებული წვდომა იმ წევრებისთვის, რომლებმაც ის უნდა გამოიყენონ. შეამოწმეთ, რომ ჩართულია როგორც Snowflake, ისე Snowflake — ოფიციალური შაბლონი.

  3. სამუშაო სივრცის ადმინისტრატორები პასუხისმგებელნი არიან მომხმარებლის წვდომის გამართვაზე იმ როლებისთვის, რომლებმაც Snowflake უნდა გამოიყენონ.

  4. სამუშაო სივრცის ადმინისტრატორები პასუხისმგებელნი არიან ხელმისაწვდომი ხელსაწყოების მოქმედებების კონტროლის პარამეტრების გადახედვაზე.

  5. სამუშაო სივრცის ადმინისტრატორებმა უნდა გადახედონ აპის ნებართვებს და განსაზღვრონ, როდის სთხოვოს ChatGPT-მა წევრებს თანხმობა აპის გამოყენებამდე.

აპის ეს ნებართვები ChatGPT-ის საუბრებზე ვრცელდება. სამუშაო სივრცის აგენტები იყენებენ თითოეული აგენტისთვის მისი შემქმნელის მიერ განსაზღვრულ მართვის პარამეტრებს. ეს პარამეტრები ადგენს, აპის რომელი მოქმედებებია ხელმისაწვდომი და როდის უნდა სთხოვონ საბოლოო მომხმარებლებს მათი დამტკიცება. აგენტების მუშაობის შესახებ იხილეთ: ChatGPT-ის სამუშაო სივრცის აგენტები Enterprise-ისა და Business-ისთვის.

გამოსცადეთ აპი

  1. გახსენით ჩატი, აირჩიეთ Snowflake და შეამოწმეთ კავშირი.

  2. დარწმუნდით, რომ ChatGPT აღმოაჩენს თქვენ მიერ გამართულ ხელსაწყოებს.

  3. ჯერ შეასრულეთ დაბალი რისკის წაკითხვის მოქმედება, მაგალითად, ძიება ან მხოლოდ წაკითხვის მოთხოვნა დამტკიცებულ მონაცემებზე.

  4. დარწმუნდით, რომ Snowflake-ის ნებართვები ზღუდავს წვდომას დამტკიცებული როლითა და ობიექტებით.

  5. სამუშაო სივრცის გამართვისას ჩაატარეთ ტესტირება წვდომის მქონე არაადმინისტრატორ წევრებთან, რომლებსაც Snowflake-ში განსხვავებული ნაგულისხმევი როლები აქვთ. ადმინისტრატორის წარმატებული დაკავშირება არ ადასტურებს, რომ დაკავშირებას ყველა წევრი შეძლებს.

სამუშაო სივრცის ადმინისტრატორებისთვის მხოლოდ Snowflake-ის ჩართვა საკმარისი არ არის. თუ Snowflake — ოფიციალური შაბლონი ჩართული და დაკავშირებული არ არის, წევრებს პლაგინი შეიძლება გამორთულად უჩანდეთ.

MCP სერვერის URL და OAuth-ის მუშაობა

ChatGPT უკავშირდება Snowflake-ის მიერ მართული MCP სერვერის სრულ URL-ს:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

ChatGPT ამ URL-იდან იყენებს Snowflake-ის ჰოსტის პრეფიქსს Snowflake-ის შემდეგი OAuth საბოლოო წერტილების მისამართების დასადგენად:

  • ავტორიზაცია: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

  • ტოკენი: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

არ ჩასვათ Snowsight-ის URL, მხოლოდ Snowflake-ის ანგარიშის ძირეული URL ან URL გზის დამატებითი სეგმენტებით. MCP-ის URL უნდა შეიცავდეს /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}-ს და ზუსტად შეესაბამებოდეს თქვენს Snowflake-ის ობიექტებს.

პრობლემების აღმოფხვრა

Snowflake ჩართულია ადმინისტრატორისთვის, მაგრამ გამორთულია წევრისთვის

  • დარწმუნდით, რომ განყოფილებაში ადმინისტრატორის კონსოლი > პლაგინები ჩართულია როგორც Snowflake, ისე Snowflake — ოფიციალური შაბლონი.

  • გახსენით Snowflake — ოფიციალური შაბლონი და დაასრულეთ მისი დაკავშირების პროცესი. შაბლონის მხოლოდ ჩართვა, დაკავშირების გარეშე, საკმარისი არ არის.

  • გახსენით Snowflake და დარწმუნდით, რომ შაბლონი მისთვის აუცილებელ აპადაა ნაჩვენები.

  • დარწმუნდით, რომ პლაგინის ინსტალაციის პოლიტიკა უშვებს იმ წევრის როლს ან ჯგუფს, რომელსაც პრობლემა შეექმნა.

MCP სერვერი ვერ მოიძებნა

  • ხელახლა შეამოწმეთ MCP სერვერის სრული URL ან შაბლონის ოთხი ველი, თუ გამართვის ეკრანი მათ ითხოვს.

  • დარწმუნდით, რომ MCP სერვერი ზუსტად იმ მონაცემთა ბაზასა და სქემაში არსებობს.

ChatGPT-ში ხელსაწყოები არ ჩანს

  • დარწმუნდით, რომ MCP სერვერის სპეციფიკაცია ხელსაწყოებს შეიცავს.

  • დარწმუნდით, რომ როლს MCP სერვერზე USAGE ნებართვა აქვს.

ხელსაწყო ჩანს, მაგრამ გამოყენებისას ვერ მუშაობს

  • დარწმუნდით, რომ როლს საჭირო ნებართვა აქვს გამოყენებულ Snowflake-ის ობიექტზე, მაგალითად, ძიების სერვისზე, სემანტიკურ ხედზე, საწყობზე, პროცედურაზე ან UDF-ზე.

SQL ხელსაწყო ვერ მუშაობს

  • დარწმუნდით, რომ საწყობის სახელი სწორია და საწყობი გაშვებულია.

  • დარწმუნდით, რომ როლს საწყობზე USAGE ნებართვა აქვს.

  • თუ მხოლოდ წაკითხვის წვდომა გსურდათ, დარწმუნდით, რომ დაყენებულია read_only: true.

მოთხოვნილი როლი ALL პირდაპირი წესით არის დაბლოკილი

სთხოვეთ Snowflake-ის ადმინისტრატორს, შეადაროს თქვენი ნაგულისხმევი როლი OAuth ინტეგრაციის დაშვებულ და დაბლოკილ როლებს. სხვა დაშვებული როლის ქონა მის ავტომატურად არჩევას არ ნიშნავს. თუ მიზანშეწონილია, ნაგულისხმევი როლი შეცვალეთ დამტკიცებული როლით და ხელახლა დაუკავშირდით. ნაგულისხმევი როლის შეცვლა გავლენას ახდენს თქვენს Snowflake-ის სესიებზეც ChatGPT-ის გარეთ.

ავტორიზაცია ვერ სრულდება

  • დარწმუნდით, რომ მომხმარებელს Snowflake-ში შესვლა შეუძლია.

  • session:role:all-ის გამოყენებისას დარწმუნდით, რომ OAuth ინტეგრაცია მომხმარებლის ნაგულისხმევ როლს უშვებს.

  • დარწმუნდით, რომ კონფიგურაცია იყენებს Snowflake-ის მიერ მართული MCP-ის OAuth პროცესს.

  • თუ მორგებულ OAuth კლიენტს იყენებთ, დარწმუნდით, რომ კლიენტის ID და კლიენტის საიდუმლო გასაღები ემთხვევა Snowflake-ის OAuth ინტეგრაციის მონაცემებს, ხოლო მისი გადამისამართების URI ზუსტად ემთხვევა ChatGPT-ში ნაჩვენებ უკუგამოძახების URL-ს.

    თუ ჩაშენებულ OAuth-ს იყენებთ, სთხოვეთ Snowflake-ის ადმინისტრატორს, შეამოწმოს, რომ ChatGPT-ის პარტნიორი ინტეგრაცია ხელმისაწვდომია და ჩართულია იმ ანგარიშში, სადაც MCP სერვერია განთავსებული.

Snowflake-ის ქსელის პოლიტიკა ან დაშვებული IP მისამართების სია კონექტორს ბლოკავს

  • სთხოვეთ Snowflake-ის ადმინისტრატორს, განაახლოს Snowflake-ის ქსელის პოლიტიკა ან წვდომის წესები.

  • დაუშვით შემომავალი კავშირები ChatGPT-ის კონექტორების გამავალი IP მისამართების მიმდინარე დიაპაზონებიდან.

  • დაშვებული მისამართების ეს სია Snowflake-ში გამართეთ. ის დამოუკიდებელია ChatGPT-ის სამუშაო სივრცის დაშვებული IP მისამართების სიისგან.

  • შეძლებისდაგვარად გააავტომატურეთ განახლება გამოქვეყნებული JSON-იდან, რადგან დიაპაზონები შეიძლება შეიცვალოს.

ჰოსტის სახელთან დაკავშირებული კავშირის პრობლემა

გამოიყენეთ Snowflake-ის ჰოსტის სწორი პრეფიქსი. Snowflake-ის ჰოსტის სახელში ქვედა ტირეებმა შეიძლება პრობლემები გამოიწვიოს; უმჯობესია დეფისების გამოყენება.

საცნობარო მასალები

სასარგებლო იყო ეს სტატია?