Condividi tramite


Snowflake

Snowflake Connector consente di creare app canvas e di visualizzare i dati Snowflake nelle tabelle virtuali, consentendo al contempo un'elaborazione e un'analisi dei dati più veloci rispetto alle soluzioni tradizionali.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Supporto snowflake
URL https://www.snowflake.com/support
Email support@snowflake.com
Metadati del connettore
Editore Snowflake
Sito web https://www.snowflake.com
Informativa sulla privacy https://www.snowflake.com/privacy-policy
Categorie Dati; Marketing

Approfondimento del connettore

Questo articolo descrive le funzionalità e le azioni del connettore Snowflake.

Funzionalità supportate per Power Automate

  • Gli utenti possono creare flussi e aggiungere azioni per eseguire e ottenere i risultati delle istruzioni SQL personalizzate con la connessione Snowflake.

Funzionalità supportate per Power Apps

Funzionalità supportate per App per la logica

  • Gli utenti possono creare flussi e aggiungere azioni per eseguire e ottenere i risultati delle istruzioni SQL personalizzate con la connessione Snowflake.

Supporto della rete virtuale

Con il supporto di Rete virtuale di Azure per Power Platform, gli utenti possono integrare Power Platform con risorse all'interno della rete virtuale senza esporli tramite la rete Internet pubblica. Per connettersi alla rete virtuale, assicurarsi di seguire entrambi i passaggi indicati di seguito.

  1. Informazioni su come configurare collegamento privato di Azure e Snowflake
  2. Informazioni su come configurare il supporto della rete virtuale per Power Platform

Per altre informazioni sulla rete virtuale, vedere Panoramica del supporto della rete virtuale.

Prerequisiti

  • Gli utenti devono avere l'ID Microsoft Entra per l'autorizzazione esterna. Il flusso di autorizzazione per PowerApps sfrutta l'entità servizio e Power Automate supporterà sia i flussi Service-Principal che per conto dell'utente.
  • Gli utenti devono avere una licenza premium di Power Apps.
  • Gli utenti devono avere un account Snowflake.

Alcuni aspetti da tenere presenti per quanto riguarda la configurazione per l'uso del connettore Snowflake

  1. Il server di autorizzazione può concedere al client OAuth un token di accesso per conto dell'utente, a cui fa riferimento DELEGATED BASED AUTH.
  2. Il server di autorizzazione può concedere al client OAuth un token di accesso per il client OAuth stesso, detto SP BASED AUTH.
  3. Per il client Oauth, assicurarsi di aggiungere un URI di reindirizzamento (basato sul Web) per l'oggetto basato su AUTHdelegato.
    URI di reindirizzamento - https://global.consent.azure-apim.net/redirect/snowflakev2URI di reindirizzamento
  4. È necessario creare un'integrazione della sicurezza con gruppi di destinatari.
  5. Per l'autenticazione basata su delega, external_oauth_token_user_mapping_claim = 'upn'
  6. Per l'autenticazione basata su sp, external_oauth_token_user_mapping_claim = 'sub'
  7. Al momento della creazione dell'integrazione della sicurezza, descrivere l'integrazione creata e verificare se il ruolo assegnato all'utente di Snowflake si trova nell'elenco bloccato o meno. Se nell'elenco bloccato, modificare o rimuovere il ruolo dell'utente nell'elenco bloccato.
    Elenco bloccato
  8. Assicurarsi che i login_name ruoli e siano impostati correttamente nell'account Snowflake. Questa opzione può essere selezionata tramite la scheda > Amministratore Utenti e ruoli > Selezionare un utente e modificare i dettagli dell'utente.
    Dettagli utente

Passaggi di configurazione

A. Configurare la risorsa OAuth in Microsoft Entra ID

  1. Passare al portale di Microsoft Azure ed eseguire l'autenticazione.
  2. Passare a Microsoft Entra ID.
  3. Fare clic su Registrazioni app.
  4. Fare clic su Nuova registrazione.
  5. Immettere "Snowflake OAuth Resource" o un valore simile al nome.
  6. Verificare che i tipi di account supportati siano impostati su Tenant singolo.
  7. Fare clic su Registra.
  8. Fare clic su Esporre un'API.
  9. Fare clic sul collegamento accanto all'URI ID applicazione per aggiungere l'URI ID applicazione. L'URI ID applicazione sarà del formato Application ID URI <api://9xxxxxxxxxxxxxxxxxx>
  10. Per l'autenticazione delegata (screenshot qui):
    1. Fare clic su Aggiungi un ambito per aggiungere un ambito che rappresenta il ruolo Snowflake.
    2. Selezionare chi può fornire il consenso.
    3. Aggiungi una descrizione.
    4. Fare clic su Aggiungi ambito per salvare.
      Esempio: session:scope:analyst

      OR

  11. Per l'autenticazione dell'entità servizio (screenshot qui):
    Per aggiungere un ruolo Snowflake come ruolo per i flussi OAuth in cui il client programmatico richiede un token di accesso per se stesso:
    1. Fare clic su Manifesto.

    2. Individuare l'elemento appRoles .

    3. Immettere un ruolo app con le impostazioni seguenti, il ruolo Snowflake deve essere quello che ha accesso a un warehouse e i privilegi di utilizzo per lo schema (vedere qui per informazioni dettagliate sui manifesti).

    4. Vedere la definizione di esempio seguente:

      Il ruolo dell'app si manifesta nel modo seguente. Evitare di usare ruoli con privilegi elevati, ad esempio ACCOUNTADMIN, SECURITYADMIN o 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. Fare clic su Salva

  12. Facoltativamente, se è già in uso un'integrazione della sicurezza in Snowflake con un altro prodotto Microsoft, ad esempio PowerBI e con un mapping di attestazioni diverso, sarà necessario modificare il manifesto. Il manifesto dovrà generare token usando un'autorità emittente diversa, in modo che sia possibile creare un'integrazione separata della sicurezza in Snowflake con il mapping di attestazioni univoco.
    a. Fare clic su Manifesto.
    b. Trovare l'attributo requestedAccessTokenVersion e impostare il valore su "2".
    • Quando requestedAccessTokenVersion è impostato su "2", il token di accesso avrà un'autorità emittente di formato: https://login.microsoftonline.com/<Tenant-ID>/v2.0
    • Quando requestedAccessTokenVersion è impostato su "1", il token di accesso avrà un'autorità emittente di formato: https://sts.windows.net/<tenant-ID>/
      c. Fare clic su Salva.

B. Creare un client OAuth in Microsoft Entra ID

  1. Passare al portale di Microsoft Azure ed eseguire l'autenticazione.
  2. Passare ad Azure Active Directory.
  3. Fare clic su Registrazioni app.
  4. Fare clic su Nuova registrazione.
  5. Immettere un nome per il client, ad esempio "Snowflake OAuth Client".
  6. Verificare che i tipi di account supportati siano impostati su Tenant singolo.
  7. Fare clic su Registra.
  8. Nella sezione Panoramica copiare dal ClientID campo ID applicazione (client). Questa operazione sarà nota come nei <OAUTH_CLIENT_ID> passaggi seguenti.
  9. Fare clic su Certificati e segreti e quindi su Nuovo segreto client.
  10. Aggiungere una descrizione del segreto.
  11. A scopo di test, selezionare segreti di lunga durata, ma per Produzione seguire i criteri di sicurezza necessari.
  12. Fare clic su Aggiungi. Copiare il segreto. Questa operazione sarà nota come nei <OAUTH_CLIENT_SECRET> passaggi seguenti.
  13. Per l'autenticazione delegata:
    a. Fare clic su Manage -API Permissions (Gestisci ->Autorizzazioni API).
    b. Fare clic su Aggiungi autorizzazione.
    c. Fare clic su My APIs (API personali).
    d. Fare clic sulla risorsa OAuth Snowflake creata in Configurare la risorsa Oauth in Microsoft Entra ID
    e. Fare clic sulla casella Autorizzazioni delegate .
    f. Controllare l'autorizzazione correlata agli ambiti definiti manualmente nell'applicazione a cui si vuole concedere il client.
    g. Fare clic su Aggiungi autorizzazioni.
    h. Fare clic sul pulsante Concedi consenso amministratore per concedere le autorizzazioni al client. Si noti che a scopo di test le autorizzazioni vengono configurate in questo modo. Tuttavia, in un ambiente di produzione, la concessione di autorizzazioni in questo modo non è consigliabile.
    i. Fare clic su .
    j. Fare clic su Gestisci -> Autenticazione, aggiungere una piattaforma - > Web e immettere URI di reindirizzamento
    https://global.consent.azure-apim.net/redirect/snowflakev2

    OR

  14. Per l'autenticazione dell'entità servizio:
    a. Fare clic su Manage -API Permissions (Gestisci ->Autorizzazioni API).
    b. Fare clic su Aggiungi autorizzazione.
    c. Fare clic su My APIs (API personali).
    d. Fare clic sulla risorsa OAuth Snowflake creata in Configurare la risorsa Oauth in Microsoft Entra ID .
    e. Fare clic sulla casella Autorizzazioni applicazione .
    f. Controllare l'autorizzazione correlata ai ruoli definiti manualmente nel manifesto dell'applicazione a cui si vuole concedere il client.
    g. Fare clic su Aggiungi autorizzazioni.
    h. Fare clic sul pulsante Concedi consenso amministratore per concedere le autorizzazioni al client. Si noti che a scopo di test le autorizzazioni vengono configurate in questo modo. Tuttavia, in un ambiente di produzione, la concessione di autorizzazioni in questo modo non è consigliabile.
    i. Fare clic su Sì.

C. Raccogliere informazioni di Azure AD per Snowflake

  1. Passare al portale di Microsoft Azure ed eseguire l'autenticazione.
  2. Passare ad Azure Active Directory.
  3. Fare clic su Registrazioni app.
  4. Fare clic sulla risorsa OAuth Snowflake creata in Configurare la risorsa Oauth in Microsoft Entra ID .
  5. Fare clic su Endpoint nell'interfaccia Panoramica.
  6. Sul lato destro copiare l'endpoint del token OAuth 2.0 (v2) e prendere nota degli URL per i metadati openID Connect e i metadati di Federation Connect.
  • L'endpoint del token OAuth 2.0 (v2) sarà noto come <AZURE_AD_OAUTH_TOKEN_ENDPOINT> nei passaggi di configurazione seguenti. L'endpoint deve essere simile a https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token.
  • Per i metadati openID Connect, aprire in una nuova finestra del browser.
    • Individuare il parametro e copiarne il jwks_uri valore.
    • Questo valore di parametro sarà noto come <AZURE_AD_JWS_KEY_ENDPOINT> nei passaggi di configurazione seguenti. L'endpoint deve essere simile a https://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keys.
  • Per il documento Metadati federazione, aprire l'URL in una nuova finestra del browser.
    • Individuare il "entityID" parametro in XML Root Element e copiarne il valore.
    • Questo valore di parametro sarà noto come <AZURE_AD_ISSUER> nei passaggi di configurazione seguenti. Il valore entityID deve essere simile a https://sts.windows.net/<tenant-id>/.

D. Convalidare l'installazione dell'autorizzazione entra

È consigliabile testare la configurazione in questo momento, usare il curl seguente e verificare se Entra emette un token usando qualsiasi strumento di test API, ad esempio Insonnia o altri.

  • Autenticazione delegata: (facoltativo)
    • Per ottenere il codice è necessario eseguire un passaggio precedente. Questo documento può essere seguito

      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
      
    • Nota: aggiungere l'URI di reindirizzamento nell'app client AAD.

OR

  • Autenticazione dell'entità servizio:

    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'
    

Per convalidare il token, eseguire il comando seguente in Snowflake:

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

E. Creare un'integrazione della sicurezza con gruppi di destinatari

Il external_oauth_audience_list parametro dell'integrazione della sicurezza deve corrispondere all'URI ID applicazione specificato durante la configurazione dell'ID Microsoft Entra.

  • Autenticazione delegata:

    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';
    

Se l'integrazione della sicurezza per Azure AD è già configurata, usare:

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

Nel caso dell'autenticazione delegata, l'utente login_name Snowflake o email_address deve corrispondere al messaggio di posta elettronica Entra dell'utente che eseguirà il flusso di Power Automate.

Esempio:

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

  • Autenticazione dell'entità servizio:

    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';
    

Continuare di seguito solo per l'installazione dell'autenticazione dell'entità servizio.

Creare un utente per la connessione basata su entità servizio:

  • Il sottovalore deve essere mappato a un utente in Snowflake, evitare di usare account con privilegi elevati 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. Convalidare l'accesso snowflake [facoltativo]

  • Autenticazione delegata

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

OR

  • Autenticazione dell'entità servizio

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

Clienti che usano Snowflake Connector [DEPRECATO]

Applicabile: tutte le aree

Per eseguire la migrazione da un connettore Snowflake precedente a quello nuovo, seguire questa procedura.

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Se un flusso di Power Automate che usa un connettore precedente è stato compilato (ora contrassegnato come deprecato), sarà necessario configurare una nuova connessione seguendo i passaggi descritti in Passaggi di configurazione precedenti e aggiornare i flussi esistenti per usare la nuova connessione.

L'azione "Convertire le righe del set di risultati da una matrice a oggetti" deve essere eliminata anche perché tale funzionalità è ora sottoposta a wrapping in "Controlla lo stato e ottieni risultati".

Problemi noti e limitazioni

  1. Attualmente non sono supportate colonne duplicate quando viene eseguito il comando join. Una soluzione alternativa consiste nell'aggiungere alias alle colonne duplicate.

  2. Altre limitazioni delle tabelle virtuali sono elencate qui.

  3. Le tabelle virtuali sono supportate solo con le connessioni create con l'autenticazione 'Entità servizio'.

  4. Quando si usa l'autenticazione con entità servizio, l'utente deve avere accesso in lettura alla tabella information_schema.columns .

  5. Le connessioni Snowflake non possono essere create direttamente nelle app Canvas, le informazioni sugli errori e i passaggi necessari per risolvere il problema sono i seguenti:

    1. Verrà visualizzato un errore se la connessione Snowflake viene creata direttamente in un'app Canvas, come illustrato nello screenshot seguente Creare un errore di connessione
    2. Invece di aggiungere il connettore direttamente nell'app Canvas, creare una connessione all'entità servizio (non delegata) dall'esterno dell'app Canvas
    3. Usare la connessione Snowflake creata in precedenza e creare un errore di connessione alla tabella virtuale
    4. Successivamente, la tabella virtuale può essere caricata nell'app Canvas e la compilazione dell'app Canvas può continuare Errore di connessione
    5. La tabella ANIMALS precedente è una tabella virtuale creata usando snowflake Connection come indicato in precedenza

Annotazioni

  1. Gli utenti devono sempre assicurarsi che tutti i dettagli dell'account Snowflake (warehouse, role, schema, database) si trovino nella stessa lettera dell'account Snowflake durante la configurazione delle azioni di connessione/flusso.
  2. Come passaggio di convalida sia per le connessioni delegate che per le entità servizio, creare un flusso di Power Automate per convalidare la connessione.

Limiti generali

Nome Value
Numero massimo di richieste elaborate contemporaneamente dal connettore 50

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Entità servizio (applicazione Microsoft Entra ID) Usare l'applicazione Microsoft Entra ID per accedere al database Snowflake. Tutte le aree geografiche Condivisibile
Autenticazione delegata dell'entità servizio (applicazione Microsoft Entra ID) Usare l'applicazione Microsoft Entra ID per accedere al database Snowflake. Tutte le aree geografiche Condivisibile
Impostazione predefinita [DEPRECATO] Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti. Tutte le aree geografiche Non condivisibile

Entità servizio (applicazione Microsoft Entra ID)

ID autenticazione: oauthSP

Applicabile: tutte le aree

Usare l'applicazione Microsoft Entra ID per accedere al database Snowflake.

Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs

Nome TIPO Description Obbligatorio
Tenant corda Vero
ID cliente corda Vero
Segreto del cliente securestring Vero
URL della risorsa corda URL gruppo di destinatari di Snowflake OAuth (URL risorsa) Vero
Snowflake SaaS URL corda URL Snowflake non incluso il prefisso HTTPS (ad esempio, fnpuupu-in12345.snowflakecomputing.com) Vero
Database Snowflake corda Specificare il database a cui connettersi Vero
Nome magazzino corda Magazzino Snowflake a cui connettersi Vero
Ruolo corda Ruolo Snowflake da connettere come Vero
Schema corda Schema Snowflake a cui connettersi Vero

Autenticazione delegata dell'entità servizio (applicazione Microsoft Entra ID)

ID autenticazione: oauthSPUserDelegated

Applicabile: tutte le aree

Usare l'applicazione Microsoft Entra ID per accedere al database Snowflake.

Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs

Nome TIPO Description Obbligatorio
ID cliente corda Snowflake OAuth Client ID Vero
Segreto del cliente securestring Segreto client OAuth snowflake Vero
URL della risorsa corda SNOWFlake OAuth Audience URL (URL risorsa) Vero

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome TIPO Description Obbligatorio
Si tratta di un segnaposto fittizio necessario per il tempo a causa di un bug del widget di connessione dell'interfaccia utente MCS. Eventuali modifiche all'autenticazione devono essere apportate in connectionParameterSets corda Si tratta di un segnaposto fittizio necessario per il tempo a causa di un bug del widget di connessione dell'interfaccia utente MCS. Eventuali modifiche all'autenticazione devono essere apportate in connectionParameterSets

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 900 60 secondi

Azioni

Annullare l'esecuzione di un'istruzione

Annullare l'esecuzione di un'istruzione

Controllare lo stato e ottenere i risultati

Controllare lo stato dell'esecuzione di un'istruzione e ottenere i risultati

Inviare un'istruzione SQL per l'esecuzione

Inviare un'istruzione SQL per l'esecuzione

Annullare l'esecuzione di un'istruzione

Annullare l'esecuzione di un'istruzione

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza
Instance True string

URI dell'istanza snowflake (senza https://)

handle di istruzione
statementHandle True string

handle di istruzione

ID richiesta
requestId string

ID richiesta

Restituisce

Nome Percorso Tipo Descrizione
codice
code string

codice

sqlState
sqlState string

sqlState

message
message string

message

statementHandle
statementHandle string

statementHandle

statementStatusUrl
statementStatusUrl string

statementStatusUrl

Controllare lo stato e ottenere i risultati

Controllare lo stato dell'esecuzione di un'istruzione e ottenere i risultati

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza
Instance True string

URI dell'istanza snowflake (senza https://)

handle di istruzione
statementHandle True string

handle di istruzione

ID richiesta
requestId string

ID richiesta

partition
partition integer

partition

nome
name string

nome

banca dati
database string

banca dati

schema
schema string

schema

table
table string

table

nullable
nullable boolean

nullable

precisione
precision integer

precisione

scale
scale integer

scale

byteLength
byteLength integer

byteLength

collazione
collation string

collazione

length
length integer

length

type
type string

type

Restituisce

Nome Percorso Tipo Descrizione
Partitions
Partitions array of object

Partitions

RowCount
Partitions.RowCount integer

RowCount

UncompressedSize
Partitions.UncompressedSize integer

UncompressedSize

CompressedSize
Partitions.CompressedSize integer

CompressedSize

Schema
Schema array of object

Schema

nome
Schema.name string

nome

banca dati
Schema.database string

banca dati

schema
Schema.schema string

schema

table
Schema.table string

table

precisione
Schema.precision integer

precisione

scale
Schema.scale integer

scale

type
Schema.type string

type

nullable
Schema.nullable boolean

nullable

byteLength
Schema.byteLength integer

byteLength

collazione
Schema.collation string

collazione

length
Schema.length integer

length

Data
Data array of

Data

StatementHandle
StatementHandle string

StatementHandle

Righe
Metadata.Rows integer

Righe

Formato
Metadata.Format string

Formato

Codice
Metadata.Code string

Codice

StatementStatusUrl
Metadata.StatementStatusUrl string

StatementStatusUrl

RequestId
Metadata.RequestId string

RequestId

SqlState
Metadata.SqlState string

SqlState

CreatedOn
Metadata.CreatedOn string

CreatedOn

StatementHandles
Metadata.StatementHandles array of string

StatementHandles dall'esecuzione di più istruzioni

Inviare un'istruzione SQL per l'esecuzione

Inviare un'istruzione SQL per l'esecuzione

Parametri

Nome Chiave Necessario Tipo Descrizione
Istanza
Instance True string

URI dell'istanza snowflake (senza https://)

ID richiesta
requestId string

ID della richiesta

Asynchronous
asyncexecution boolean

Indica se la query deve essere eseguita in modo asincrono

Annulabile
nullable boolean

Se nullable è false, i valori Null verranno sostituiti da string

dichiarazione
statement string

Istruzione SQL da eseguire: batch di istruzioni non ancora supportate

timeout
timeout integer

Numero di secondi prima del timeout

banca dati
database string

banca dati

schema
schema string

schema

magazzino
warehouse string

magazzino

ruolo
role string

ruolo

timezone
timezone string

Fuso orario da usare durante l'esecuzione dell'istruzione.

tag di query
query_tag string

Tag di query da associare all'istruzione SQL.

formato di output binario
binary_output_format string

Formato di output per i valori binari.

formato di output della data
date_output_format string

Formato di output per i valori DATE.

formato di output dell'ora
time_output_format string

Formato di output per i valori TIME.

formato di output timestamp
timestamp_output_format string

Formato di output per i valori TIMESTAMP.

formato di output timestamp ltz
timestamp_ltz_output_format string

Formato di output per i valori TIMESTAMP_LTZ.

timestamp_ntz_output_format
timestamp_ntz_output_format string

Formato di output per i valori TIMESTAMP_NTZ.

formato di output timestamp tz
timestamp_tz_output_format string

Formato di output per i valori TIMESTAMP_TZ.

conteggio di istruzioni multi
MULTI_STATEMENT_COUNT integer

Numero di istruzioni da eseguire quando si usa la funzionalità con più istruzioni. 0 implica il numero variabile di istruzioni. I numeri negativi non sono consentiti.

Restituisce

Nome Percorso Tipo Descrizione
Partitions
Partitions array of object

Partitions

RowCount
Partitions.RowCount integer

RowCount

UncompressedSize
Partitions.UncompressedSize integer

UncompressedSize

CompressedSize
Partitions.CompressedSize integer

CompressedSize

Schema
Schema array of object

Schema

nome
Schema.name string

nome

banca dati
Schema.database string

banca dati

schema
Schema.schema string

schema

table
Schema.table string

table

nullable
Schema.nullable boolean

nullable

precisione
Schema.precision integer

precisione

scale
Schema.scale integer

scale

byteLength
Schema.byteLength integer

byteLength

collazione
Schema.collation string

collazione

length
Schema.length integer

length

type
Schema.type string

type

Data
Data array of

Data

Righe
Metadata.Rows integer

Righe

Formato
Metadata.Format string

Formato

Codice
Metadata.Code string

Codice

StatementStatusUrl
Metadata.StatementStatusUrl string

StatementStatusUrl

RequestId
Metadata.RequestId string

RequestId

SqlState
Metadata.SqlState string

SqlState

StatementHandle
Metadata.StatementHandle string

StatementHandle

StatementHandles
Metadata.StatementHandles array of string

StatementHandles dall'esecuzione di più istruzioni

CreatedOn
Metadata.CreatedOn string

CreatedOn