Määritä Snowflake MCP Notionille

Tässä ohjeasiakirjassa

Opi yhdistämään Snowflake mukautettuihin palvelijoihin tai Notion-palvelijaasi, jotta voit kysyä kysymyksiä yrityksesi tiedoista Notionissa.

Siirry usein kysyttyihin kysymyksiin

Jotkin ominaisuudet ovat alfa-vaiheessa.

Jotkin tässä artikkelissa käsitellyt ominaisuudet, mukaan lukien työtilaan määritetyt MCP-yhteydet ja käyttäjäkohtainen valtuutus mukautetuissa palvelijoissa, ovat tällä hetkellä alfa-vaiheessa, eivätkä ne välttämättä ole vielä käytettävissä työtilassasi.

Jos haluat pyytää käyttöoikeutta, ota yhteyttä Notion-asiakkuustiimiisi tai hae data-agenttien early access -ohjelmaamme →

Mukautetut palvelijasi ja Notion-palvelijasi voivat muodostaa yhteyden Snowflakeen Snowflaken ajaman MCP (Model Context Protocol) -palvelimen kautta. Kun se on määritetty, voit kysyä palvelijaltasi Snowflake-tietovarastosi tiedoista ja saada vastauksia suoraan Notionissa.

Määritys tapahtuu vaiheittain, ja jokaisella vaiheella on eri omistaja:

  • Snowflake-ylläpitäjä määrittää roolin, varaston ja Snowflake-hallinnoidun MCP-palvelimen.

  • Notion-työtilan omistaja tai ylläpitäjä määrittää Snowflake MCP -yhteyden työtilalle.

  • Työtilan jäsenet voivat sitten muodostaa yhteyden Snowflake MCP:hen mukautetuista palvelijoista käyttämällä omia Snowflake-tunnuksiaan tai yhdistää Snowflaken suoraan Notion-palvelijaansa. Tämän artikkelin vaiheet 1–10 ovat samat molemmille poluille. Polut erkanevat vaiheessa 11 sen mukaan, minkä palvelijan haluat yhdistää.

  • Käytettävissä olevat työkalut voivat vaihdella Snowflake-pilvialueesi mukaan.

  • Snowflaken hallinnoitu MCP-palvelin ei ole käytettävissä Manner-Kiinassa tai hallinnon alueilla.

  • Työtilasi on oltava Business- tai Enterprise-sopimuksella.

  • Käytä Notionia verkossa tai työpöytäsovelluksella. Tämä ominaisuus ei ole käytettävissä mobiililaitteilla.

  • Yritykselläsi on oltava Snowflake-käyttäjätili.

  • Mukautetun palvelijan rakentamiseen tarvitset käyttöoikeuden luoda palvelijoita työtilaasi.

Jaettu määritys ei anna kaikille samoja tietoja.

Työtila tallentaa yhteystiedot, mukaan lukien OAuth-asiakastunnus ja salasana. Nämä tiedot määrittävät yhteyden; ne eivät ole jaettu kirjautumistunnus. Jokainen kirjauduu Snowflakeen omalla käyttäjätilillään. Olipa kyseessä mukautettu palvelija tai oma Notion-palvelija, palvelija voi käyttää vain niitä tietoja, joihin kyseisellä käyttäjätilillä on käyttöoikeus.

Ennen kuin tiimisi voi yhdistää Snowflaken Notioniin, Snowflake-ylläpitäjän on määritettävä käyttöoikeudet. Tämä on työläin vaihe, ja sen tarvitsee tehdä vain kerran. Tee yhteistyötä Notion-työtilan ylläpitäjän kanssa: Notion tarjoaa uudelleenohjaus-URI:n ja Snowflake tarjoaa OAuth-asiakastunnuksen ja salaisuuden.

Määrität roolin ja varaston, luot Snowflake-hallinnoidun MCP-palvelimen, myönnät sille käyttöoikeuden tarvittaviin resursseihin, määrität OAuth-laajuuden ja tietoturvaintegraation sekä lisäät verkkokäytännön, jos organisaatiosi sitä vaatii.

Täytä tämä lomake yhteistyössä Notion-työtilan ylläpitäjän kanssa ennen aloittamista. Jäsenet voivat ohittaa sen ja kirjautua sisään omilla Snowflake-käyttäjätileillään, kun määritys on valmis.

Pidä OAuth-asiakassalasana yksityisenä.

Älä lisää sitä Slackiin, tukipyyntöihin, versionhallintaan tai terminaalin historiaan. Jaa se vain hyväksytyn suojatun kanavan kautta.

Kenttä

Arvo

Omistaja

Snowflake-tilin tunniste

<organization-account>

Snowflake-ylläpitäjä

MCP-tietokanta

<database_name>

Snowflake-ylläpitäjä

MCP-skeema

<schema_name>

Snowflake-ylläpitäjä

MCP-palvelin

<mcp_server_name>

Snowflake-ylläpitäjä

Varasto

<warehouse_name>

Snowflake-ylläpitäjä

Käyttöoikeusrooli

<mcp_access_role>

Snowflake-ylläpitäjä

Palvelimen URL-osoite

https://<account_host>/api/v2/databases/<database_name>/schemas/<schema_name>/mcp-servers/<mcp_server_name>

Snowflake-ylläpitäjä

Ensisijaisen roolin laajuus

session:role:<mcp_access_role>

Snowflake-ylläpitäjä

Uudelleenohjauksen URI-osoite

Kopioi Notionin luoma URI-osoite

Notion-työtilan ylläpitäjä

OAuth-asiakasohjelman tunnus

Nouda Snowflakesta

Snowflake-ylläpitäjä

OAuth-asiakasohjelmasalaisuus

Siirrä hyväksytyn salaisen kanavan kautta

Snowflake-ylläpitäjä

Tilin isäntänimi käyttää yhdysviivoja, ei alaviivoja. Varmista, että jokainen palvelimen URL-osoitteen objektinimi vastaa vastaavaa objektinimeä Snowflakessa.

Käytä mahdollisuuksien mukaan erillistä, mahdollisimman vähäoikeuksista roolia ja yhtä hyväksyttyä varastoa.

Rajoitettu rooli ilman toissijaisia rooleja (suositus). Tätä mallia on helpompi ymmärtää ja auditoida. Määritä OAUTH_USE_SECONDARY_ROLES = NONE, määritä ALLOWED_ROLES_LIST ja käytä Notion-laajuutta session:role:<mcp_access_role>.

Käyttäjän oletusarvoiset toissijaiset roolit (valinnainen). Käytä tätä mallia vain, kun palvelin tarvitsee kunkin käyttäjän Snowflake DEFAULT_SECONDARY_ROLES -asetuksesta perittyjä oikeuksia. Määritä OAUTH_USE_SECONDARY_ROLES = IMPLICIT, jätä ALLOWED_ROLES_LIST pois ja käytä eksplisiittistä ensisijaisen roolin laajuutta. Snowflake ei salli IMPLICIT toissijaisia rooleja ALLOWED_ROLES_LIST -asetuksen kanssa, joten jätä sallittujen luettelo pois, kun käytät tätä mallia.

Käytä MCP-palvelimelle mahdollisuuksien mukaan erillistä, mahdollisimman vähäoikeuksista roolia.

Myönnä tämä rooli normaalin identiteetinhallintaprosessisi kautta. Jos Okta tai SCIM hallinnoi Snowflaken roolijäsenyyksiä, älä lisää käyttäjiä manuaalisesti prosessin ulkopuolella.

Luo tai valitse tietokanta ja skeema, jotka ovat palvelinta käyttävän tiimin omistuksessa.

Hallittuja liiketoimintakysymyksiä varten voit tuoda Cortex-palvelijan jäsenten käytettäväksi työkaluksi. Se pitää semanttiset näkymät, vahvistetut kyselyt, haun ja orkestroinnin yhdessä paikassa. Cortex-palvelija on valinnainen. Jos luot sellaisen, käytä alla olevaa määritystä. Jos korvaat olemassa olevan palvelijan, varmista, että korvaava palvelija vastaa hyväksyttyä määritystäsi.

execution_environment on pysyttävä sisäkkäisenä Analyst-työkaluresurssin alla.

Jos asetat warehouse-kohdan ylimmälle tasolle, palvelijan määritys voidaan luoda, mutta työkalulla ei ole suoritustietovarastoa ajon aikana.

Muita tuettuja Snowflake MCP -työkalutyyppejä ovat CORTEX_ANALYST_MESSAGE, CORTEX_SEARCH_SERVICE_QUERY, GENERIC ja SYSTEM_EXECUTE_SQL.

Jos tarvitset suoran SQL-yhteyden, sijoita se erilliselle MCP-palvelimelle, jolla on oma vähimpien oikeuksien rooli, ja varmista, että kyseinen rooli on vain luku -muotoinen.

SYSTEM_EXECUTE_SQL-oikeuden lisääminen hallitun agentin palvelimelle voi antaa asiakkaille mahdollisuuden ohittaa sen semanttiset näkymät ja vahvistetut kyselyt.

Anna jokaiselle työkalulle selkeä nimi ja kuvaus. Selitä, mitä tietoja se kattaa, kuinka yksityiskohtaisia sen tulokset ovat ja milloin sitä tulee käyttää. Tämä auttaa palvelijaa valitsemaan oikean työkalun.

MCP-palvelimen USAGE-oikeus antaa roolille mahdollisuuden muodostaa yhteys palvelimeen ja löytää sen työkalut. Se ei anna roolille käyttöoikeutta varastoon, palvelijaan, semanttiseen näkymään, hakupalveluun, tallennettuun proseduuriin tai taustalla olevaan dataan. Myönnä roolille käyttöoikeus jokaiseen resurssiin, jota palvelimen työkalut tarvitsevat.

Myönnä käyttöoikeus vain niihin lisäresursseihin, joita kukin työkalu tarvitsee. Myönnä esimerkiksi SELECT-oikeus hyväksyttyyn semanttiseen näkymään, USAGE-oikeus Cortex Haku -palveluun tai USAGE-oikeus tiettyyn funktioon tai proseduuriin. Älä myönnä roolia PUBLIC-käyttäjille äläkä lisää laajoja oikeuksia nykyisille tai tuleville objekteille.

Ennen kuin määrität OAuthin, tarkista MCP-palvelin ja sen myönnetyt oikeudet:

Määritä MCP-skeema mainostamaan tarkkaa roolia, jota jäsenten tulisi pyytää:

Käytä eksplisiittistä roolilaajuutta. Älä käytä arvoa session:role:all. Snowflake käsittelee kyseisen arvon käyttäjän oletusarvoisena ensisijaisena roolina, ei pääsynä jokaiseen rooliin, ja etuoikeutettujen roolien käytännöt saattavat estää sen. Eksplisiittinen rooli tekee pyydetystä pääsystä selkeän ja helpommin tarkistettavan.

Ennen kuin suoritat tämän SQL-koodin, koordinoi asia Notion-työtilan ylläpitäjän kanssa. Pyydä heitä syöttämään Snowflake-palvelimen URL-osoite työtilan MCP-asetuslomakkeeseen ja ottamaan käyttöön asetukset Manually configure authentication ja Use a workspace-shared OAuth client. Notion luo uudelleenohjaus-URI-osoitteen. Kopioi se ja lähetä se Snowflaken ylläpitäjälle. Kun Snowflake on luonut asiakastunnuksen ja salaisuuden, työtilan ylläpitäjä voi viimeistellä yhteyden määrityksen.

Käytä uudelleenohjaus-URI-osoitetta täsmälleen sellaisena kuin Notion sen antaa. Älä lisää loppuviivaa tai kyselyparametreja, äläkä muuta isäntää.

Asetus IS_AGENTIC = TRUE merkitsee tämän integraation kautta luodut istunnot palvelija-istunnoiksi. Snowflaken IS_AGENT_ACTIVATED()-funktio palauttaa tällöin TRUE, mikä mahdollistaa palvelija-spesifisen auditoinnin ja hallinnan. Jos käytät valinnaista toissijaisen roolin mallia, aseta OAUTH_USE_SECONDARY_ROLES = IMPLICIT ja jätä ALLOWED_ROLES_LIST pois.

Päivitystunnisteen voimassaoloaika 7776000 sekuntia vastaa 90 päivää. Varmista ennen sen käyttöä, että se vastaa organisaatiosi uudelleenvaltuutus- ja tunnisteiden kierrätyskäytäntöjä. Vältä rutiinimuutoksissa komentoa CREATE OR REPLACE SECURITY INTEGRATION. Integraation korvaaminen voi keskeyttää olemassa olevat yhteydet.

Voit tarkistaa integraation näyttämättä sen salaisuutta suorittamalla:

Varmista, että integraatio on päällä, uudelleenohjaus-URI täsmää täydellisesti, rooli on sallittu eikä estetty, päivitystunnisteet ja PKCE ovat käytössä ja että sekä valtuutus- että tunniste-päätepisteet käyttävät Snowflaken julkista tilin isäntää.

Tämä vaihe tarvitaan vain, jos organisaatiosi edellyttää verkkokäytäntöä. Pyydä tietoturva- tai verkkovastaavaasi hyväksymään Notionin nykyiset lähtevän liikenteen alueet.

OAuth-integraation on sallittava molemmat Notion-polut:

  1. API-polku, joka käsittelee OAuth-takaisinkutsut ja vaihtaa valtuutuskoodit

  2. työtilan ajonaikainen polku, joka vahvistaa yhteydet, suorittaa työkaluja ja päivittää tunnisteet

Nämä polut voivat käyttää eri Notion-lähtöliikenteen osoitteita. Jos sallit vain alkuperäisen tunnisteiden vaihdon aikana käytetyn osoitteen, kirjautuminen saattaa onnistua, mutta vahvistus tai tunnisteiden päivitys voi epäonnistua. Käytä Notionin nykyisiä, hyväksyttyjä lähtevän liikenteen alueita. Älä lisää kertaluonteista IP-osoitetta selaimesta tai logista tuotannon sallittujen luetteloon.

Liitä tämä verkkokäytäntö OAuth-integraatioon, älä yksittäisiin käyttäjiin. Älä muuta tilin laajuisia käytäntöjä selaimen sisäänkirjautumista, VPN-yhteyttä tai käyttäjän verkkoyhteyttä varten. Jos verkkokäytäntö estää tunnuksen pyynnön, Snowflake saattaa palauttaa invalid_client. Tämä virhe ei välttämättä tarkoita, että asiakastunnus tai salaisuus on väärä.

Suorita tämä suojatussa Snowflake-laskentataulukossa. Integraation nimi on kirjainkokoriippuvainen ja yleensä isoilla kirjaimilla:

Jaa asiakastunnus ja sitä vastaava salaisuus Notion-työtilan ylläpitäjälle hyväksyttyä suojattua kanavaa käyttäen. Snowflake tarjoaa kaksi kelvollista salaisuutta, joten voit vaihtaa niitä ilman käyttökatkoja. Älä koskaan liitä kumpaakaan salaisuutta dokumentaatioon, keskusteluun, tukipyyntöihin tai lähdekoodin hallintaan.

Työtilakohtaisesti määritetyt MCP-yhteydet ovat ominaisuus, joka on tällä hetkellä alfa-vaiheessa.

Jos työtilallasi ei ole vielä käyttöoikeutta, ota yhteyttä Notion-asiakkuustiimiisi tai hae mukaan data-agenttiemme early access -ohjelmaan.

Kun Snowflake on valmis, työtilan omistaja tai ylläpitäjä lisää palvelimen kerran työtilaa varten. Jäsenet voivat sen jälkeen löytää sen näkemättä OAuth-asiakassalaisuutta, riippumatta siitä, yhdistävätkö he Snowflake MCP:n mukautettuun palvelijaan vai omaan Notion-palvelijaansa.

  1. Siirry työtilan Asetukset-kohtaan.

  2. Valitse Yhteydet → Työtilan jaetut MCP:t.

  3. Valitse Uusi työtilan MCP.

Täytä nämä kentät ja valitse sitten Lisää MCP-palvelin:

Kenttä

Mitä syötetään

Nimi

Selkeä, jäsenille näkyvä nimi, kuten Company Snowflake Data Agent.

Kuvaus

Lyhyt muistiinpano tiedoista ja siitä, miten niitä on tarkoitus käyttää.

Palvelimen URL-osoite

Tarkka julkinen Snowflake MCP -URL-osoite laskentataulukosta.

Määritä todennus manuaalisesti

Ota käyttöön. Notion tunnistaa Snowflaken OAuth-tiedot.

Käytä työtilan jaettua OAuth-asiakasohjelmaa

Ota käyttöön.

Uudelleenohjauksen URI-osoite

Notionin luoma. Varmista, että se vastaa URI-osoitetta, jonka annoit Snowflake-ylläpitäjälle.

Asiakasohjelman tunnus

Asiakasohjelman tunnus Snowflake OAuth -integraatiosta.

Asiakasohjelmasalaisuus

Vastaava salaisuus, jonka sait hyväksytyn salaisuuskanavan kautta.

OAuth-laajuudet

Valitse tarkka session:role:<mcp_access_role> laajuus. All scopes on hyväksyttävä vain, kun Snowflake ilmoittaa kyseisestä yhdestä hyväksytystä laajuudesta eikä mistään laajemmasta.

Kun olet tallentanut, varmista, että uusi rivi näkyy kohdassa Shared with this workspace ja että Workspace OAuth client näyttää tilan Configured.

Mitä tämä määritys tekee:

  • Auttaa jäseniä löytämään hyväksytyn palvelimen.

  • Tallentaa OAuth-asiakasohjelmasalaisuuden kerran Notionin salattuun yhteystallennustilaan.

  • Varmistaa, että jäsenet kirjautuvat sisään hyväksymälläsi palvelimen URL-osoitteella, asiakasohjelmalla ja laajuuksilla.

  • Ei luo jaettua Snowflake-istuntoa eikä ohita Snowflaken käyttöoikeuksia.

  • Ei yhdistä jokaista jäsentä automaattisesti. Jokaisen on kirjauduttava sisään erikseen.

Jos poistat tämän määrityksen, uudet jäsenet eivät voi enää löytää palvelinta. Aiemmat yhteydet saattavat edelleen näkyä, joten koordinoi tämä muutos Snowflaken käyttöoikeuksien peruuttamisen ja olemassa olevien yhteyksien poistamisen kanssa.

Kun ylläpitäjäsi ovat saaneet Snowflake MCP -yhteyden valmiiksi, voit käyttää sitä kahdella tavalla. Jos määrität tätä tiimillesi, aloita kohdasta 11A. Jos haluat vain esittää omia kysymyksiäsi, siirry kohtaan 11B. Voit tehdä molemmat; ne ovat erillisiä yhteyksiä.

Mukautettu palvelija tarjoaa tiimillesi yhden paikan, josta kysyä Snowflake-datasta. Yhdistät Snowflaken kerran, lisäät ohjeet mittareistasi ja taulukoistasi ja jaat palvelijan tiimillesi. Jokaisen sitä käyttävän on kirjauduttava Snowflakeen omilla tunnuksillaan, joten jokainen saa vastauksia vain niiden tietojen perusteella, joita heillä on lupa tarkastella.

Henkilökohtainen todennus mukautetuissa palvelijoissa on tällä hetkellä alfa-vaiheessa.

Jos työtilallasi ei ole vielä käyttöoikeutta, ota yhteyttä Notion-asiakkuustiimiisi tai hae mukaan data-agenttiemme early access -ohjelmaan.

Yhdistä Snowflake mukautettuun palvelijaan

  1. Avaa mukautettu palvelijasi tai luo uusi.

  2. Siirry kohtaan Asetukset → Työkalut ja käyttöoikeudet.

  3. Valitse Lisää yhteys ja valitse sitten Snowflake-palvelin, jonka kohdalla lukee Työtilan hallinnoima. Älä valitse Mukautettu MCP-palvelin tai syötä palvelimen URL-osoitetta manuaalisesti.

  4. Kirjaudu Snowflakeen selaimessasi. Organisaatiosi tavallinen Okta- tai SSO-kirjautuminen saattaa tulla näkyviin.

  5. Tarkista ja hyväksy pyydetty Snowflake-rooli.

  6. Valitse, mitä työkaluja palvelija voi käyttää. Jätä kirjoitusoikeudelliset työkalut ja CORTEX_AGENT_RUN pyytämään hyväksyntää, kunnes olet testannut ne.

  7. Valitse Yhdistä ja vahvista, että yhteyden tilana näkyy Yhdistetty.

Anna palvelijalle kontekstia

Yhteys antaa palvelijalle käyttöoikeuden Snowflakeen. Ohjeesi kertovat sille, miten yrityksesi käyttää kyseistä dataa. Kuvaile palvelijan ohjeissa, mitä työkaluja käytetään mihinkin kysymyksiin, miten tiimisi määrittelee keskeiset mittarit ja mistä taulukoista tai semanttisista näkymistä kannattaa aloittaa. Muutama vahvistettu esimerkkikysymys auttaa pitkälle. Valmiin aloituspisteen löydät Data Scout -työkalupakin oppaasta.

Jaa palvelija

Jaa palvelija tiimillesi samalla tavalla kuin jaat minkä tahansa mukautetun palvelijan. Kun joku kysyy siltä ensimmäistä kertaa kysymyksen, joka vaatii Snowflakea, häntä pyydetään kirjautumaan sisään omalla Snowflake-tilillään. Häneltä ei kysytä asiakastunnusta tai salasanaa.

Henkilökohtainen todennus on käytössä, kun joku keskustelee suoraan palvelijan kanssa.

Ajastetuilla ja käynnistetyillä suorituksilla ei ole kirjautunutta käyttäjää, joten ne eivät voi vielä käyttää kenenkään Snowflake-käyttöoikeutta. Jos tarvitset Snowflake-tietoja aikataulun mukaisesti, keskustele Snowflake-ylläpitäjäsi kanssa ennen määritysten tekemistä.

Jos haluat kysyä omia kysymyksiäsi omassa keskustelussasi, yhdistä Snowflake Notion-palvelijaasi. Kirjaudut sisään omalla Snowflake-tililläsi, joten palvelijasi pääsee käsiksi vain siihen, mitä sinulla on lupa tarkastella.

  1. Siirry kohtaan Asetukset → Notion AI.

  2. Valitse kohdassa MCP-palvelimet vaihtoehto Lisää MCP-palvelin.

  3. Valitse Snowflake-palvelin, jonka kohdalla lukee Työtilan hallinnoima. Älä valitse Mukautettu MCP-palvelin tai syötä palvelimen URL-osoitetta manuaalisesti.

  4. Valitse Yhdistä.

  5. Kirjaudu Snowflakeen selaimessasi. Organisaatiosi tavallinen Okta- tai SSO-kirjautuminen saattaa tulla näkyviin.

  6. Tarkista ja hyväksy pyydetty Snowflake-rooli.

  7. Kun selaimesi kysyy, avataanko Notion, valitse Avaa Notion.

  8. Vahvista, että palvelimen tila on Yhdistetty, ei Vaatii todennuksen.

Kun olet muodostanut yhteyden, Snowflake näkyy chatissa kohdassa Kaikki lähteet → MCP-palvelimet.

Sinulta ei pitäisi kysyä OAuth-asiakastunnusta tai -salaisuutta kummallakaan polulla.

Jos Notion kysyy jompaakumpaa, olet ehkä valinnut mukautetun MCP-vaihtoehdon työtilan hallinnoiman palvelimen sijaan, tai ylläpitäjäsi ei ehkä ole ottanut käyttöön asetusta Käytä työtilan jaettua OAuth-asiakasta. Palaa takaisin ja valitse sen sijaan Työtilan hallinnoima -palvelin.

  1. Esitä vaaraton kysymys, johon on tiedossa oleva vastaus ja jonka pitäisi käyttää Snowflakea.

  2. Vahvista, että agentti käyttää Snowflakea ja palauttaa tuloksen.

  3. Vahvista, ettet pääse käsiksi tietoihin, jotka ovat sinulle annetun roolin ulkopuolella.

Jos määrität mukautetun palvelijan, pyydä myös tiimin jäsentä, jolla on rajatumpi Snowflake-rooli, kokeilemaan sitä. Hänen pitäisi nähdä vain omat tietonsa, ei sinun tietojasi. Se on nopein tapa vahvistaa, että palvelija käyttää kunkin henkilön käyttöoikeuksia eikä luojan käyttöoikeuksia.

Tarkempaa tarkistusta varten pyydä Snowflake-ylläpitäjääsi vahvistamaan käyttäjäsi, roolisi, tietovarastosi ja kyselyhistoriasi. Onnistunut sisäänkirjautuminen vahvistaa henkilöllisyytesi, mutta se ei vahvista, että jokainen käyttöoikeus on oikein.

Esitä palvelijalle jokin tietty kysymys Snowflake-tiedoistasi. Esimerkiksi:

  • "Mitkä olivat Snowflake-tietojen mukaan kokonaisrekisteröitymistemme määrä viime kuussa?"

  • "Mitkä olivat Snowflake-tietojen mukaan tämän vuosineljänneksen 10 suurimman liikevaihdon asiakastilejä?"

Mukautetun palvelijan kohdalla voit yleensä jättää "Snowflakesta" pois, kunhan sen ohjeet tekevät selväksi, milloin sitä käytetään. Notion-palvelijan kohdalla Snowflaken nimeäminen auttaa palvelijaa valitsemaan oikean lähteen.

Laajat pyynnöt voivat kestää kauemmin tai aikakatkaista. Jos näin käy, esitä rajatumpi kysymys tai jaa pyyntö pienempiin kysymyksiin.

Useimmiten pysyt yhdistettynä tekemättä mitään. Snowflake käyttää lyhytikäisiä pääsytunnuksia, ja Notion päivittää ne taustalla. Vanheneva pääsytunnus ei itsessään katkaise yhteyksiäsi.

Sinun on kirjauduttava uudelleen sisään, jos:

  • Päivitystunnuksesi vanhenee tai ylläpitäjä peruuttaa sen

  • Ylläpitäjä korvaa OAuth-integraation tai asiakassalaisuuden

  • Snowflake-roolisi poistetaan

  • Ylläpitäjä poistaa työtilan määrityksen tai yhteytesi.

  • Verkkokäytäntö estää tunnuksen päivityksen

Mukautetun palvelijan kohdalla jokaisen henkilön sisäänkirjautuminen on erillinen. Jos yhtä henkilöä pyydetään kirjautumaan uudelleen, se ei vaikuta muihin, eikä palvelijan rakentaneen henkilön tarvitse tehdä mitään.

Jos kierrätät asiakassalaisuutta: Käytä Snowflaken kahden salaisuuden kiertoa integraation korvaamisen sijaan. Pidä molemmat salaisuudet voimassa riittävän pitkään, jotta voit päivittää ja testata työtilan määrityksen ennen vanhan käytöstä poistamista.

ALTER SECURITY INTEGRATION <oauth_integration_name>
REFRESH OAUTH_CLIENT_SECRET_2;

  • Snowflake MCP -yhteyttä ei ole luettelossa. Työtilan ylläpitäjä ei ehkä ole vielä lisännyt sitä, tai työtilasi saattaa rajoittaa mukautettuja palvelijoita. Pyydä apua ylläpitäjältäsi.

  • Sinulta pyydetään asiakastunnusta tai salaisuutta. Valitsit todennäköisesti mukautetun MCP-vaihtoehdon. Palaa takaisin ja valitse sen sijaan Snowflake-palvelin, joka on merkitty Workspace Managed.

  • Sinua pyydetään kirjautumaan uudelleen. Snowflake-istuntosi on saattanut vanhentua tai ylläpitäjä on saattanut päivittää yhteyden. Kirjaudu Snowflakeen uudelleen.

  • Avasit mukautettu palvelijan ja se pyysi sinua kirjautumaan Snowflakeen. Tämä on odotettavissa ensimmäisellä kerralla. Jokaisen hallittua mukautettua palvelijaa käyttävän henkilön on kirjauduttava sisään omilla Snowflake-tunnuksillaan.

  • Tiimin jäsenet saavat erilaisia tuloksia samasta mukautetusta palvelijasta. Tämä on odotettavissa. Palvelija käyttää kunkin henkilön Snowflake-käyttöoikeutta, joten eri rooleissa olevat henkilöt näkevät eri tietoja.

  • Mukautettu palvelija toimii keskustelussa, mutta ei ajoitetusti. Ajoitetuilla ja käynnistetyillä suoritusilla ei ole kirjautunutta henkilöä, joten ne eivät voi vielä käyttää Snowflakea henkilökohtaisella sisäänkirjautumisella.

  • Kirjauduit sisään, mutta se ei muodosta yhteyttä tai työkalut epäonnistu. Sisäänkirjautuminen todistaa henkilöllisyytesi, mutta käyttöoikeutesi riippuu silti Snowflake-lisensseistä. Pyydä Snowflake-ylläpitäjääsi vahvistamaan, että roolisi pääsee palvelimelle, tietovarastoon, palvelijaan ja tietoihin.

  • Palvelija ei löydä taulukkoa. Palvelija pääsee vain niihin tietoihin, joihin Snowflake-käyttäjätilisi pääsee. Tarkista Snowflake-käyttöoikeutesi ja sisällytä taulukon nimi kysymykseesi.

  • Pyyntö aikakatkaistaan. Esitä tarkempi kysymys tai jaa pyyntösi pienempiin kysymyksiin.

Nämä virheet johtuvat yleensä Snowflaken asetuksista, eivät Notionista. Jaa ne Snowflake-ylläpitäjällesi.

  • Palvelimen URL-osoite näyttää kaksinkertaiselta, kuten https://https%3A... Osoite liitettiin siten, että edessä on ylimääräinen https://. Korjaa se niin, että URL-osoite alkaa vain yhdellä https://.

  • Näet virheen "This server does not support OAuth authentication." Tietoturvaintegraatiota ei ole määritetty OAuthia varten tai palvelimen URL-osoite on väärä. Pyydä Snowflake-ylläpitäjääsi tarkistamaan OAuth-tietoturvaintegraatio ja palvelimen URL-osoite.

  • Näet virheen invalid_client kirjautumisen tai päivittämisen aikana. Asiakastunnus tai salaisuus on väärä, tai salaisuus on vaihdettu. Pyydä ylläpitäjältäsi nykyinen asiakastunnus ja salaisuus.

  • Kirjautuminen toimii, mutta epäonnistuu heti. Roolisi ei ehkä tavoita palvelinta, tai rooli tai verkkosääntö estää istunnon. Pyydä ylläpitäjääsi tarkistamaan käyttöoikeutesi ja käytäntösi.

  • Näet viestin "The role ALL requested has been explicitly blocked." Yhteys pyysi kaikkia rooleja kerralla (session:role:all), mikä on estetty. Käytä sen sijaan yhtä tarkkaa roolia, kuten session:role:analyst, oikealla roolinimelläsi.

  • Näet uudelleenohjausvirheen (virhe 390307). Snowflakessa tallennettu uudelleenohjaus-URL ei vastaa Notionin käyttämää URL-osoitetta. Pyydä ylläpitäjääsi asettamaan tietoturvaintegraation uudelleenohjaus-URL täsmälleen Notionin arvoa vastaavaksi.

  • Näet virheen 390311, joka koskee virheellistä koodihaastetta. Tämä on PKCE-yhteensopimattomuus. Pyydä ylläpitäjääsi vahvistamaan, että OAUTH_ENFORCE_PKCE on asetettu oikein tietoturvaintegraatiossa.

  • Olet yhteydessä, mutta työkaluja ei näy. Rooliltasi saattaa puuttua USAGE-oikeus MCP-palvelimeen. Pyydä ylläpitäjääsi vahvistamaan käyttöoikeus ja suorita sitten DESCRIBE MCP SERVER asetusten tarkistamiseksi.

  • Pääset käsiksi odotettua laajempaan tai suppeampaan tietomäärään. Toissijaiset roolit muuttavat sitä, mitä istuntosi voi nähdä. Tarkista ylläpitäjäsi kanssa, mitkä roolit ovat aktiivisina istunnossasi.

  • Se toimi aiemmin, mutta nyt kaikki epäonnistuvat salaisuuden vaihtamisen jälkeen. Asiakassalaisuus päivitettiin, joten tallennettu yhteys on vanhentunut. Pyydä ylläpitäjältäsi uusi salaisuus ja muodosta yhteys uudelleen.

  • Se toimi aiemmin, mutta nyt se epäonnistuu vain sinun kohdallasi. Rooli, käyttöoikeus tai käytäntö on saattanut muuttua, tai istuntosi on vanhentunut. Kirjaudu sisään uudelleen ja pyydä ylläpitäjääsi vahvistamaan, ettei käyttöoikeutesi ole muuttunut.

  • Tilitunnuksesi hylätään. Käytä organization-account-muotoa, jossa on yhdysviiva, kuten myorg-myaccount, äläkä käytä pisteitä.

  • PrivateLink-käyttäjätili ei voi muodostaa yhteyttä. PrivateLink-käyttäjätilit vaativat ylimääräisiä verkkoasetuksia. Kysy ylläpitäjältäsi, salliiko PrivateLink Notion-yhteyden.

  • Snowflake ei ole käytettävissä aikataulutetuissa tai käynnistetyissä suorituksissa. Näissä suorituksissa ei ole kirjautunutta henkilöä, joten ne eivät voi vielä käyttää henkilökohtaista kirjautumista. Suorita pyyntösi sen sijaan keskustelussa.

  • Näet oauth_security_error selaimeen kirjautumisen jälkeen. Tilitason verkkokäytäntö saattaa estää pyynnön. Ylläpitäjäsi voi vahvistaa tämän suorittamalla:

  • Kirjautuminen näyttää toimivan, mutta saat roolivirheen, vaikka käytössä on oikea laajuus. Oletusroolisi saattaa olla estetty, esimerkiksi ACCOUNTADMIN tai rooli BLOCKED_ROLES_LIST-listassa. Ylläpitäjäsi voi tarkistaa ja korjata sen:

Nämä vain luku -komennot auttavat ylläpitäjääsi vahvistamaan asetukset muuttamatta mitään. Suorita ne Snowflakessa.

ACCOUNT_USAGE-näkymissä voi olla viivettä, joten puuttuva rivi ei ole todiste siitä, ettei pyyntöä olisi tapahtunut.

Älä vaihda salaisuuksia, heikennä käytäntöjä tai laajenna käyttöoikeuksia, ennen kuin tiedät, mikä kerros epäonnistuu.

Käytä näitä Snowflake-oppaita asetusten viimeistelyyn:


Usein kysytyt kysymykset

Pitäisikö minun määrittää mukautetut palvelijat vai yhdistää Snowflake Notion-palvelijaani?

Jos määrität Snowflake MCP -yhteyttä tiimillesi, luo mukautettu palvelija. Se antaa kaikille samat ohjeet, samat määritelmät mittareillesi ja yhden paikan, josta kysyä kysymyksiä, vaikka jokainen kirjautuu sisään omilla Snowflake-tunnuksillaan. Jos haluat vain esittää omia kysymyksiäsi, yhdistä Snowflake MCP Notion-palvelijaasi. Voit tehdä molemmat.

Yhdistääkö Snowflake Notion-palvelijaasi myös meidän mukautettuun palvelijaamme?

Ei. Jokainen on erillinen yhteys, ja jokainen mukautettu palvelija tarvitsee oman yhteytensä. Snowflaken määritys vaiheista 1–10 on jaettu; kirjautuminen ei.

Näkevätkö kaikki tiimin jäsenet samat tiedot?

Ei. Jokainen kirjautuu Snowflakeen omilla tunnuksillaan, ja palvelija pääsee käsiksi vain siihen, mihin kyseinen käyttäjätili pääsee. Tämä pätee myös mukautettuun palvelijaamme.

Pitääkö minun jakaa Snowflake-salasanani tiimini kanssa?

Ei. Kukaan ei jaa tunnuksiaan. Työtila tallentaa OAuth-asiakastiedot kerran, ja jokainen kirjautuu Snowflakeen itse.


Anna palautetta

Oliko tästä resurssista apua?


Powered by Fruition