Sdílet prostřednictvím

Snowflake

Konektor Snowflake umožňuje vytvářet aplikace plátna a povrchová data Snowflake ve virtuálních tabulkách a zároveň umožňuje rychlejší zpracování a analýzu dat v porovnání s tradičními řešeními.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Podpora Snowflake
URL https://www.snowflake.com/support
Email support@snowflake.com
Metadata konektoru
Vydavatel Snowflake
Internetová stránka https://www.snowflake.com
Zásady ochrany osobních údajů https://www.snowflake.com/privacy-policy
Kategorie Data; Marketing

Hloubková spojnice

Tento článek popisuje možnosti a akce konektoru Snowflake.

Podporované funkce pro Power Automate

  • Uživatelé můžou vytvářet toky a přidávat akce ke spuštění a získání výsledků vlastních příkazů SQL pomocí připojení Snowflake.

Podporované možnosti pro Power Apps

Podporované možnosti pro Logic Apps

  • Uživatelé můžou vytvářet toky a přidávat akce ke spuštění a získání výsledků vlastních příkazů SQL pomocí připojení Snowflake.

Podpora virtuálních sítí

Díky podpoře služby Azure Virtual Network pro Power Platform můžou uživatelé integrovat Power Platform s prostředky ve své virtuální síti, aniž by je zpřístupňuje přes veřejný internet. Pokud se chcete připojit k virtuální síti, nezapomeňte postupovat podle obou níže uvedených kroků.

  1. Informace o nastavení služby Azure Private Link a Snowflake
  2. Zjistěte, jak nastavit podporu virtuální sítě pro Power Platform.

Další informace o virtuální síti najdete v přehledu podpory virtuálních sítí.

Požadavky

  • Uživatelé musí mít ID Microsoft Entra pro externí autorizaci. Tok autorizace pro PowerApps využívá instanční objekt a Power Automate bude podporovat toky Service-Principal i toky uživatelů jménem uživatele.
  • Uživatelé musí mít licenci Premium Power Apps.
  • Uživatelé musí mít účet Snowflake.

Je potřeba mít na paměti několik věcí, které se týkají konfigurace pro použití konektoru Snowflake.

  1. Autorizační server může klientovi OAuth udělit přístupový token jménem uživatele, na který DELEGATED BASED AUTHodkazuje .
  2. Autorizační server může klientovi OAuth udělit přístupový token pro samotného klienta OAuth, označovaného jako SP BASED AUTH.
  3. Pro klienta Oauth nezapomeňte přidat identifikátor URI přesměrování (webový) pro delegovaný .AUTH
    Identifikátor URI přesměrování – https://global.consent.azure-apim.net/redirect/snowflakev2identifikátor URI přesměrování
  4. Je potřeba vytvořit integraci zabezpečení s cílovými skupinami.
  5. Pro delegovaný ověřování na základě external_oauth_token_user_mapping_claim = 'upn'
  6. Pro ověřování na základě sp external_oauth_token_user_mapping_claim = 'sub'
  7. Při vytváření integrace zabezpečení popište vytvořenou integraci a zkontrolujte, jestli je role udělená uživateli Snowflake v seznamu blokovaných nebo ne. Pokud je v seznamu blokovaných, změňte nebo odeberte roli uživatele v seznamu blokovaných.
    Blokovaný seznam
  8. Ujistěte se, že login_name jsou v účtu Snowflake správně nastavené role a role. Můžete to zkontrolovat prostřednictvím karty > Správce Uživatelé a role > Vybrat uživatele a upravit podrobnosti o uživateli.
    Podrobnosti o uživateli

Kroky konfigurace

A. Konfigurace prostředku OAuth v Microsoft Entra ID

  1. Přejděte na web Microsoft Azure Portal a ověřte ho.
  2. Přejděte na Microsoft Entra ID.
  3. Klikněte na Registrace aplikací.
  4. Klikněte na Nová registrace.
  5. Zadejte "Snowflake OAuth Resource" nebo podobnou hodnotu jako Název.
  6. Ověřte, že podporované typy účtů jsou nastavené na jednoho tenanta.
  7. Klikněte na Zaregistrovat.
  8. Klikněte na Zveřejnit rozhraní API.
  9. Kliknutím na odkaz vedle identifikátoru URI ID aplikace přidejte identifikátor URI ID aplikace. Identifikátor URI ID aplikace bude ve formátu. Application ID URI <api://9xxxxxxxxxxxxxxxxxx>
  10. Pro delegovaný ověřování ( tady jsou snímky obrazovky):
    1. Kliknutím na Přidat obor přidáte obor představující roli Snowflake.
    2. Vyberte, kdo může souhlasit.
    3. Umožňuje přidat popis.
    4. Kliknutím na Přidat obor uložte.
      Příklad: session:scope:analyst

      OR

  11. Pro ověřování instančního objektu ( tady jsou snímky obrazovky):
    Přidání role Snowflake jako role pro toky OAuth, kde programový klient požaduje přístupový token pro sebe:

    1. Klikněte na manifest.

    2. appRoles Vyhledejte prvek.

    3. Zadejte roli aplikace s následujícím nastavením, role Snowflake by měla být role, která má přístup k skladu, a oprávnění k použití schématu (podrobnosti o manifestu vales najdete tady ).

    4. Podívejte se na ukázkovou definici níže:

      Manifesty role aplikace jsou následující. Vyhněte se používání rolí s vysokými oprávněními, jako je ACCOUNTADMIN, SECURITYADMIN nebo ORGADMIN. 

       "appRoles":[
     {
         "allowedMemberTypes": [ "Application" ],
         "description": "Analyst.",
         "displayName": "Analyst",
         "id": "3ea51f40-2ad7-4e79-aa18-12c45156dc6a",
         "isEnabled": true,
         "lang": null,
         "origin": "Application",
         "value": "session:role:analyst"
     }
 ]

    5. Klikněte na Uložit.

  12. Volitelně platí, že pokud se integrace zabezpečení už používá ve Snowflake s jiným produktem Microsoftu, jako je PowerBI a s jiným mapováním deklarací identity, bude potřeba manifest upravit. Manifest bude muset generovat tokeny pomocí jiného vystavitele, aby bylo možné vytvořit samostatnou integraci zabezpečení ve Snowflake s jedinečným mapováním deklarací identity.
    a. Klikněte na manifest.
    b) Vyhledejte atribut requestedAccessTokenVersion a nastavte hodnotu na 2.
    • Pokud requestedAccessTokenVersion je nastavená hodnota 2, přístupový token bude mít vystavitele formátu: https://login.microsoftonline.com/<Tenant-ID>/v2.0
    • Pokud requestedAccessTokenVersion je nastavená hodnota 1, přístupový token bude mít vystavitele formátu: https://sts.windows.net/<tenant-ID>/
      c. Klikněte na Uložit.

B. Vytvoření klienta OAuth v Microsoft Entra ID

  1. Přejděte na web Microsoft Azure Portal a ověřte ho.
  2. Přejděte do Azure Active Directory.
  3. Klikněte na Registrace aplikací.
  4. Klikněte na Nová registrace.
  5. Zadejte název klienta, například Snowflake OAuth Client.
  6. Ověřte, že podporované typy účtů jsou nastavené na jednoho tenanta.
  7. Klikněte na Zaregistrovat.
  8. V části Přehled zkopírujte ClientID pole ID aplikace (klienta). Tento postup se označuje jako <OAUTH_CLIENT_ID> v následujících krocích.
  9. Klikněte na Certifikáty a tajné kódy a pak na Nový tajný klíč klienta.
  10. Přidejte popis tajného kódu.
  11. Pro účely testování vyberte dlouhodobé tajné kódy, ale pro produkční prostředí postupujte podle nezbytných zásad zabezpečení.
  12. Klikněte na tlačítko Přidat. Zkopírujte tajný kód. Tento postup se označuje jako <OAUTH_CLIENT_SECRET> v následujících krocích.
  13. Pro delegovaný ověřování:
    a. Klikněte na Spravovat oprávnění ->API.
    b) Klikněte na Přidat oprávnění.
    c. Klikněte na Moje rozhraní API.
    d. Klikněte na prostředek Snowflake OAuth vytvořený v části Konfigurace prostředku Oauth v Microsoft Entra ID.
    e. Klikněte na pole Delegovaná oprávnění .
    f. Zkontrolujte oprávnění související s obory ručně definovanými v aplikaci, které mají být uděleny tomuto klientovi.
    gram Klikněte na Přidat oprávnění.
    h. Kliknutím na tlačítko Udělit souhlas správce udělte klientovi oprávnění. Všimněte si, že pro účely testování se oprávnění konfigurují tímto způsobem. V produkčním prostředí se ale udělení oprávnění tímto způsobem nedoporučuje.
    i. Klikněte na Ano.
    j. Klikněte na Spravovat –> Ověřování, přidejte platformu – > Web a zadejte identifikátor URI přesměrování.
    https://global.consent.azure-apim.net/redirect/snowflakev2

    OR

  14. Pro ověřování instančního objektu:
    a. Klikněte na Spravovat oprávnění ->API.
    b) Klikněte na Přidat oprávnění.
    c. Klikněte na Moje rozhraní API.
    d. Klikněte na prostředek Snowflake OAuth , který byl vytvořen v konfiguraci prostředku Oauth v Microsoft Entra ID .
    e. Klikněte na pole Oprávnění aplikace .
    f. Zkontrolujte oprávnění související s rolemi ručně definovanými v manifestu aplikace, které mají být uděleny tomuto klientovi.
    gram Klikněte na Přidat oprávnění.
    h. Kliknutím na tlačítko Udělit souhlas správce udělte klientovi oprávnění. Všimněte si, že pro účely testování se oprávnění konfigurují tímto způsobem. V produkčním prostředí se ale udělení oprávnění tímto způsobem nedoporučuje.
    i. Klikněte na Ano.

C. Shromažďování informací o Azure AD pro Snowflake

  1. Přejděte na web Microsoft Azure Portal a ověřte ho.
  2. Přejděte do Azure Active Directory.
  3. Klikněte na Registrace aplikací.
  4. Klikněte na prostředek Snowflake OAuth, který byl vytvořen v konfiguraci prostředku Oauth v Microsoft Entra ID .
  5. V rozhraní Přehled klikněte na koncové body.
  6. Na pravé straně zkopírujte koncový bod tokenu OAuth 2.0 (v2) a poznamenejte si adresy URL metadat OpenID Connect a metadata služby Federation Connect.
  • Koncový bod tokenu OAuth 2.0 (v2) se označuje jako <AZURE_AD_OAUTH_TOKEN_ENDPOINT> v následujících krocích konfigurace. Koncový bod by měl být podobný https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token.
  • Metadata OpenID Connect otevřete v novém okně prohlížeče.
    • jwks_uri Vyhledejte parametr a zkopírujte jeho hodnotu.
    • Tato hodnota parametru <AZURE_AD_JWS_KEY_ENDPOINT> se označuje jako v následujících krocích konfigurace. Koncový bod by měl být podobný https://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keys.
  • V dokumentu federačních metadat otevřete adresu URL v novém okně prohlížeče.
    • "entityID" Vyhledejte parametr v hodnotě XML Root Element a zkopírujte její hodnotu.
    • Tato hodnota parametru <AZURE_AD_ISSUER> se označuje jako v následujících krocích konfigurace. Hodnota entityID by měla být podobná hodnotě https://sts.windows.net/<tenant-id>/.

D. Ověření nastavení autorizace Entra

V tuto chvíli se doporučuje otestovat konfiguraci, použijte následující curl a zkontrolujte, jestli Entra vydává token pomocí libovolného testovacího nástroje rozhraní API, jako je například spánku nebo jiné.

  • Delegovaný ověřování: (volitelné)

    • Abyste získali kód, musíte provést předchozí krok. Tento dokument je možné sledovat. 

      curl --request POST --url https://login.microsoftonline.com/<TENANT_ID>/oauth2/token --header 'Content-Type: multipart/form-data' --form client_id=<AAD_CLIENT_ID> --form client_secret=< AAD_CLIENT_SECRET> --form resource=< AAD_RESOURCE_ID> --formgrant_type=authorization_code --form code=<CODE_GENERATED_ABOVE> --form redirect_uri=https://localhost

    • Poznámka: Do klientské aplikace AAD přidejte identifikátor URI přesměrování.

OR

  • Ověřování instančního objektu: 

    curl -X POST -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \ --data-urlencode "client_id=client_id from above B.8" \ --data-urlencode "client_secret=<Secret from above B.12>" \ --data-urlencode "grant_type=client_credentials" \ --data-urlencode "scope=api://<Appl_URI_ID>/.default" \'https://login.microsoftonline.com/<tenant_id>/oauth2/v2.0/token'

Token ověříte spuštěním následujícího příkazu ve Snowflakeu: 

select system$verify_external_oauth_token(‘<token>’);

E. Vytvoření integrace zabezpečení s cílovými skupinami

Parametr external_oauth_audience_list integrace zabezpečení musí odpovídat identifikátoru URI ID aplikace, který byl zadán při konfiguraci ID Microsoft Entra.

  • Delegovaná ověřování: 

    create security integration external_oauth_azure_1    
    type = external_oauth
    enabled = true
    external_oauth_type = azure
    external_oauth_issuer = '<AZURE_AD_ISSUER>'
    external_oauth_jws_keys_url = '<AZURE_AD_JWS_KEY_ENDPOINT>'
    external_oauth_audience_list = ('<SNOWFLAKE_APPLICATION_ID_URI>')
    external_oauth_token_user_mapping_claim = ‘upn’ 
    external_oauth_snowflake_user_mapping_attribute = 'login_name or email address';

Pokud je integrace zabezpečení pro Azure AD už nastavená, použijte: 

alter security integration external_oauth_azure_1 set external_oauth_token_user_mapping_claim = ('sub','upn');

V případě delegovaného ověřování by měl login_name uživatel Snowflake odpovídat email_address e-mailu Entra uživatele, který spustí tok Power Automate.

Příklad: 

ALTER USER SNOWSQL_DELEGATE_USER  
LOGIN_NAME = '<ENTRA-USERID>' or EMAIL_ADDRESS = ‘ENTRA-USERID’ 
DISPLAY_NAME = 'SnowSQL Delegated User'  
COMMENT = 'A delegate user for SnowSQL client to be used for OAuth based connectivity';

OR

  • Ověřování instančního objektu: 

    create security integration external_oauth_azure_2 
    type = external_oauth 
    enabled = true 
    external_oauth_type = azure 
    external_oauth_issuer = '<AZURE_AD_ISSUER>' 
    external_oauth_jws_keys_url = '<AZURE_AD_JWS_KEY_ENDPOINT>' 
    external_oauth_audience_list = ('<SNOWFLAKE_APPLICATION_ID_URI>') 
    external_oauth_token_user_mapping_claim = ‘sub’     
    external_oauth_snowflake_user_mapping_attribute = 'login_name';

Pokračujte níže pouze pro nastavení ověřování instančního objektu.

Vytvořte uživatele pro připojení založené na instančním objektu:

  • Podhodnoce by se měla namapovat na uživatele ve Snowflake, aby se zabránilo použití účtů s vysokými oprávněními Accountadmin, Orgadmin, Securityadmin.

    CREATE OR REPLACE USER SNOWSQL_OAUTH_USER  
LOGIN_NAME = '<subvalue from decoded token>'  
DISPLAY_NAME = 'SnowSQL OAuth User'  
COMMENT = 'A system user for SnowSQL client to be used for OAuth based connectivity'; 

CREATE ROLE ANALYST; 

GRANT ROLE ANALYST TO USER SNOWSQL_OAUTH_USER;

F. Ověření přístupu Snowflake [Volitelné]

  • Delegovaný ověřování

    snowsql -a organization-locator -u 'user@sandbox.onmicrosoft.com' --rolename <rolename> --authenticator oauth --token "<token-value>"

OR

  • Ověřování instančního objektu

    snowsql -a <snowflake-accountname> -u ‘sub-value’ -r <snowflake-role from A.11.h above> –authenticator oauth –token <output from curl at step D>

Zákazníci používající konektor Snowflake [ZASTARALÉ]

Použitelné: Všechny oblasti

Pokud chcete migrovat ze staršího konektoru Snowflake na nový konektor, postupujte podle následujících kroků.

Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze kvůli zpětné kompatibilitě.

Pokud byl tok Power Automate používající předchozí konektor vytvořený (nyní označený jako zastaralý), bude potřeba nastavit nové připojení podle kroků popsaných v části Kroky konfigurace výše a aktualizovat stávající toky tak, aby používaly nové připojení.

Akce "Převést řádky sady výsledků z pole na objekty" by také bylo potřeba vynechat, protože tato funkce je teď zabalená v části Zkontrolovat stav a získat výsledky.

Známé problémy a omezení

  1. V současné době nepodporujeme duplicitní sloupce při spuštění příkazu join. Alternativním řešením je přidat aliasy do duplicitních sloupců.

  2. Tady jsou uvedená další omezení virtuálních tabulek.

  3. Virtuální tabulky se podporují pouze u připojení vytvořená s ověřováním instančního objektu.

  4. Při použití ověřování instančních objektů musí mít uživatel přístup pro čtení k tabulce information_schema.columns .

  5. Připojení Snowflake nelze vytvořit přímo v aplikacích plátna, informace o chybách a kroky potřebné k vyřešení problému:

    1. Chyba se zobrazí, pokud se připojení Snowflake vytvoří přímo v aplikaci plátna, jak je znázorněno na následujícím snímku obrazovky Chyba vytvoření připojení.
    2. Místo přidání konektoru přímo do aplikace plátna vytvořte připojení instančního objektu (nedelegováno) mimo aplikaci plátna.
    3. Použijte výše vytvořené připojení Snowflake a vytvořte chybu připojení virtuální tabulky.
    4. Potom je možné virtuální tabulku načíst do aplikace plátna a sestavení aplikace Plátno může pokračovat v chybě připojení.
    5. Výše uvedená tabulka ANIMALS je virtuální tabulka vytvořená pomocí připojení Snowflake, jak je uvedeno výše.

Poznámka:

  1. Uživatelé vždy musí zajistit, aby všechny podrobnosti o účtu Snowflake (sklad, role, schéma, databáze) byly ve stejném písmenu jako účet Snowflake při konfiguraci akcí připojení nebo toku.
  2. Jako ověřovací krok pro delegovaná připojení i připojení na základě instančního objektu vytvořte tok Power Automate pro ověření připojení.

Obecné limity

Název Hodnota
Maximální počet žádostí zpracovávaných konektorem současně 50

Vytvoření připojení

Konektor podporuje následující typy ověřování:
Instanční objekt (aplikace Microsoft Entra ID) Pro přístup k databázi Snowflake použijte aplikaci Microsoft Entra ID. Všechny oblasti Sdíletelný
Delegovaný ověřování instančního objektu (aplikace Microsoft Entra ID) Pro přístup k databázi Snowflake použijte aplikaci Microsoft Entra ID. Všechny oblasti Sdíletelný
Výchozí [ZASTARALÉ] Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu. Všechny oblasti Nesdílitelné

Instanční objekt (aplikace Microsoft Entra ID)

ID ověřování: oauthSP

Použitelné: Všechny oblasti

Pro přístup k databázi Snowflake použijte aplikaci Microsoft Entra ID.

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

Název Typ Description Povinné
Tenant řetězec Pravdivé
ID klienta řetězec Pravdivé
Tajný klíč klienta securestring Pravdivé
Adresa URL prostředku řetězec Adresa URL cílové skupiny Snowflake OAuth (adresa URL prostředku) Pravdivé
Snowflake SaaS URL řetězec Snowflake URL nezahrnuje předponu HTTPS (např. fnpuupu-in12345.snowflakecomputing.com) Pravdivé
Databáze Snowflake řetězec Zadejte databázi, ke které se chcete připojit. Pravdivé
Název skladu řetězec Snowflake Warehouse pro připojení Pravdivé
Role řetězec Role Snowflake pro připojení jako Pravdivé
Schema řetězec Schéma Snowflake pro připojení Pravdivé

Delegovaný ověřování instančního objektu (aplikace Microsoft Entra ID)

ID ověřování: oauthSPUserDelegated

Použitelné: Všechny oblasti

Pro přístup k databázi Snowflake použijte aplikaci Microsoft Entra ID.

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

Název Typ Description Povinné
ID klienta řetězec ID klienta Snowflake OAuth Pravdivé
Tajný klíč klienta securestring Tajný klíč klienta Snowflake OAuth Pravdivé
Adresa URL prostředku řetězec Adresa URL cílové skupiny Snowflake OAuth (adresa URL prostředku) Pravdivé

Výchozí [ZASTARALÉ]

Použitelné: Všechny oblasti

Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
Jedná se o fiktivní zástupný symbol potřebný pro čas kvůli chybě widgetu uživatelského rozhraní MCS. Všechny změny ověřování by se měly provádět v parametrech connectionParameterSets. řetězec Jedná se o fiktivní zástupný symbol potřebný pro čas kvůli chybě widgetu uživatelského rozhraní MCS. Všechny změny ověřování by se měly provádět v parametrech connectionParameterSets.

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 900 60 sekund

Akce

Kontrola stavu a získání výsledků

Zkontrolujte stav spuštění příkazu a získejte výsledky.
Odeslání příkazu SQL ke spuštění

Odeslání příkazu SQL pro spuštění
Zrušení spuštění příkazu

Zrušení spuštění příkazu

Kontrola stavu a získání výsledků

ID operace:
GetResults

Zkontrolujte stav spuštění příkazu a získejte výsledky.

Parametry

Name Klíč Vyžadováno Typ Description
Instance
 Instance True string

Identifikátor URI vaší instance Snowflake (bez https://)
popisovač příkazu
 statementHandle True string

popisovač příkazu
ID žádosti
 requestId string

ID žádosti
oddíl
 partition integer

oddíl
název
 name string

název
databáze
 database string

databáze
schéma
 schema string

schéma
tabulka
 table string

tabulka
vynulovatelný
 nullable boolean

vynulovatelný
přesnost
 precision integer

přesnost
škálování
 scale integer

škálování
byteLength
 byteLength integer

byteLength
kolace
 collation string

kolace
length
 length integer

length
typ
 type string

typ

Návraty

Name Cesta Typ Description
Oddíly
 Partitions array of object

Oddíly
RowCount
 Partitions.RowCount integer

RowCount
Nekomprimace
 Partitions.UncompressedSize integer

Nekomprimace
Komprimace
 Partitions.CompressedSize integer

Komprimace
Schema
 Schema array of object

Schema
název
 Schema.name string

název
databáze
 Schema.database string

databáze
schéma
 Schema.schema string

schéma
tabulka
 Schema.table string

tabulka
přesnost
 Schema.precision integer

přesnost
škálování
 Schema.scale integer

škálování
typ
 Schema.type string

typ
vynulovatelný
 Schema.nullable boolean

vynulovatelný
byteLength
 Schema.byteLength integer

byteLength
kolace
 Schema.collation string

kolace
length
 Schema.length integer

length
Data
 Data array of

Data
StatementHandle
 StatementHandle string

StatementHandle
Řádky
 Metadata.Rows integer

Řádky
Formát
 Metadata.Format string

Formát
Code
 Metadata.Code string

Code
StatementStatusUrl
 Metadata.StatementStatusUrl string

StatementStatusUrl
ID požadavku
 Metadata.RequestId string

ID požadavku
SqlState
 Metadata.SqlState string

SqlState
CreatedOn
 Metadata.CreatedOn string

CreatedOn
StatementHandles
 Metadata.StatementHandles array of string

PříkazHandles z provádění více příkazů

Odeslání příkazu SQL ke spuštění

ID operace:
ExecuteSqlStatement

Odeslání příkazu SQL pro spuštění

Parametry

Name Klíč Vyžadováno Typ Description
Instance
 Instance True string

Identifikátor URI vaší instance Snowflake (bez https://)
ID žádosti
 requestId string

ID požadavku
Asynchronous
 asyncexecution boolean

Označuje, jestli se má dotaz spustit asynchronně.
Nullovatelný
 nullable boolean

Pokud je nullable false, hodnoty null budou nahrazeny řetězcem.
příkaz
 statement string

Příkaz SQL, který se má spustit – dávky příkazů ještě nejsou podporovány.
timeout
 timeout integer

Počet sekund před vypršením časového limitu
databáze
 database string

databáze
schéma
 schema string

schéma
warehouse
 warehouse string

warehouse
role
 role string

role
timezone
 timezone string

Časové pásmo, které se má použít při provádění příkazu.
značka dotazu
 query_tag string

Značka dotazu, kterou chcete přidružit k příkazu SQL.
binární výstupní formát
 binary_output_format string

Výstupní formát binárních hodnot.
Formát výstupu data
 date_output_format string

Výstupní formát pro hodnoty DATE
formát časového výstupu
 time_output_format string

Výstupní formát pro hodnoty TIME.
Formát výstupu časového razítka
 timestamp_output_format string

Výstupní formát pro hodnoty TIMESTAMP.
formát výstupu časového razítka ltz
 timestamp_ltz_output_format string

Výstupní formát pro TIMESTAMP_LTZ hodnoty
timestamp_ntz_output_format
 timestamp_ntz_output_format string

Výstupní formát pro hodnoty TIMESTAMP_NTZ
formát výstupu tz časového razítka
 timestamp_tz_output_format string

Výstupní formát pro TIMESTAMP_TZ hodnoty
multi statement count
 MULTI_STATEMENT_COUNT integer

Početpříkazůch 0 znamená proměnlivý počet příkazů. Záporná čísla nejsou povolená.

Návraty

Name Cesta Typ Description
Oddíly
 Partitions array of object

Oddíly
RowCount
 Partitions.RowCount integer

RowCount
Nekomprimace
 Partitions.UncompressedSize integer

Nekomprimace
Komprimace
 Partitions.CompressedSize integer

Komprimace
Schema
 Schema array of object

Schema
název
 Schema.name string

název
databáze
 Schema.database string

databáze
schéma
 Schema.schema string

schéma
tabulka
 Schema.table string

tabulka
vynulovatelný
 Schema.nullable boolean

vynulovatelný
přesnost
 Schema.precision integer

přesnost
škálování
 Schema.scale integer

škálování
byteLength
 Schema.byteLength integer

byteLength
kolace
 Schema.collation string

kolace
length
 Schema.length integer

length
typ
 Schema.type string

typ
Data
 Data array of

Data
Řádky
 Metadata.Rows integer

Řádky
Formát
 Metadata.Format string

Formát
Code
 Metadata.Code string

Code
StatementStatusUrl
 Metadata.StatementStatusUrl string

StatementStatusUrl
ID požadavku
 Metadata.RequestId string

ID požadavku
SqlState
 Metadata.SqlState string

SqlState
StatementHandle
 Metadata.StatementHandle string

StatementHandle
StatementHandles
 Metadata.StatementHandles array of string

PříkazHandles z provádění více příkazů
CreatedOn
 Metadata.CreatedOn string

CreatedOn

Zrušení spuštění příkazu

ID operace:
Cancel

Zrušení spuštění příkazu

Parametry

Name Klíč Vyžadováno Typ Description
Instance
 Instance True string

Identifikátor URI vaší instance Snowflake (bez https://)
popisovač příkazu
 statementHandle True string

popisovač příkazu
ID žádosti
 requestId string

ID žádosti

Návraty

Name Cesta Typ Description
kód
 code string

kód
sqlState
 sqlState string

sqlState
zpráva
 message string

zpráva
statementHandle
 statementHandle string

statementHandle
statementStatusUrl
 statementStatusUrl string

statementStatusUrl