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 |
| 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
- Gli utenti devono prima creare tabelle virtuali e quindi caricarle in app con la connessione Snowflake (una connessione creata usando solo l'autenticazione dell'entità servizio). Informazioni su come creare tabelle virtuali: Creare e modificare tabelle virtuali con Microsoft Dataverse - Power Apps | Microsoft Learn.
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.
- Informazioni su come configurare collegamento privato di Azure e Snowflake
- 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
- Il server di autorizzazione può concedere al client OAuth un token di accesso per conto dell'utente, a cui fa riferimento
DELEGATED BASED AUTH. - Il server di autorizzazione può concedere al client OAuth un token di accesso per il client OAuth stesso, detto
SP BASED AUTH. - 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/snowflakev2
- È necessario creare un'integrazione della sicurezza con gruppi di destinatari.
- Per l'autenticazione basata su delega,
external_oauth_token_user_mapping_claim = 'upn' - Per l'autenticazione basata su sp,
external_oauth_token_user_mapping_claim = 'sub' - 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.
- Assicurarsi che i
login_nameruoli 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.
Passaggi di configurazione
A. Configurare la risorsa OAuth in Microsoft Entra ID
- Passare al portale di Microsoft Azure ed eseguire l'autenticazione.
- Passare a Microsoft Entra ID.
- Fare clic su Registrazioni app.
- Fare clic su Nuova registrazione.
- Immettere "Snowflake OAuth Resource" o un valore simile al nome.
- Verificare che i tipi di account supportati siano impostati su Tenant singolo.
- Fare clic su Registra.
- Fare clic su Esporre un'API.
- 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> - Per l'autenticazione delegata (screenshot qui):
- Fare clic su Aggiungi un ambito per aggiungere un ambito che rappresenta il ruolo Snowflake.
- Selezionare chi può fornire il consenso.
- Aggiungi una descrizione.
- Fare clic su Aggiungi ambito per salvare.
Esempio:session:scope:analyst
OR
- 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:Fare clic su Manifesto.
Individuare l'elemento
appRoles.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).
Vedere la definizione di esempio seguente:
Il ruolo dell'app si manifesta nel modo seguente. Evitare di usare ruoli con privilegi elevati, ad esempioACCOUNTADMIN,SECURITYADMINoORGADMIN."appRoles":[ { "allowedMemberTypes": [ "Application" ], "description": "Analyst.", "displayName": "Analyst", "id": "3ea51f40-2ad7-4e79-aa18-12c45156dc6a", "isEnabled": true, "lang": null, "origin": "Application", "value": "session:role:analyst" } ]Fare clic su Salva
- 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'attributorequestedAccessTokenVersione 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.
- Quando
B. Creare un client OAuth in Microsoft Entra ID
- Passare al portale di Microsoft Azure ed eseguire l'autenticazione.
- Passare ad Azure Active Directory.
- Fare clic su Registrazioni app.
- Fare clic su Nuova registrazione.
- Immettere un nome per il client, ad esempio "Snowflake OAuth Client".
- Verificare che i tipi di account supportati siano impostati su Tenant singolo.
- Fare clic su Registra.
- Nella sezione Panoramica copiare dal
ClientIDcampo ID applicazione (client). Questa operazione sarà nota come nei<OAUTH_CLIENT_ID>passaggi seguenti. - Fare clic su Certificati e segreti e quindi su Nuovo segreto client.
- Aggiungere una descrizione del segreto.
- A scopo di test, selezionare segreti di lunga durata, ma per Produzione seguire i criteri di sicurezza necessari.
- Fare clic su Aggiungi. Copiare il segreto. Questa operazione sarà nota come nei
<OAUTH_CLIENT_SECRET>passaggi seguenti. - 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 Sì.
j. Fare clic su Gestisci -> Autenticazione, aggiungere una piattaforma - > Web e immettere URI di reindirizzamento
https://global.consent.azure-apim.net/redirect/snowflakev2
OR
- 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
- Passare al portale di Microsoft Azure ed eseguire l'autenticazione.
- Passare ad Azure Active Directory.
- Fare clic su Registrazioni app.
- Fare clic sulla risorsa OAuth Snowflake creata in Configurare la risorsa Oauth in Microsoft Entra ID .
- Fare clic su Endpoint nell'interfaccia Panoramica.
- 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 ahttps://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_urivalore. - Questo valore di parametro sarà noto come
<AZURE_AD_JWS_KEY_ENDPOINT>nei passaggi di configurazione seguenti. L'endpoint deve essere simile ahttps://login.microsoftonline.com/<tenant-id>/discovery/v2.0/keys.
- Individuare il parametro e copiarne il
- Per il documento Metadati federazione, aprire l'URL in una nuova finestra del browser.
- Individuare il
"entityID"parametro inXML Root Elemente copiarne il valore. - Questo valore di parametro sarà noto come
<AZURE_AD_ISSUER>nei passaggi di configurazione seguenti. Il valore entityID deve essere simile ahttps://sts.windows.net/<tenant-id>/.
- Individuare il
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://localhostNota: 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
Attualmente non sono supportate colonne duplicate quando viene eseguito il comando join. Una soluzione alternativa consiste nell'aggiungere alias alle colonne duplicate.
Altre limitazioni delle tabelle virtuali sono elencate qui.
Le tabelle virtuali sono supportate solo con le connessioni create con l'autenticazione 'Entità servizio'.
Quando si usa l'autenticazione con entità servizio, l'utente deve avere accesso in lettura alla tabella information_schema.columns .
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:
- Verrà visualizzato un errore se la connessione Snowflake viene creata direttamente in un'app Canvas, come illustrato nello screenshot seguente
un 
- Invece di aggiungere il connettore direttamente nell'app Canvas, creare una connessione all'entità servizio (non delegata) dall'esterno dell'app Canvas
- Usare la connessione Snowflake creata in precedenza e creare un
alla tabella virtuale - Successivamente, la tabella virtuale può essere caricata nell'app Canvas e la compilazione dell'app Canvas può continuare

- La tabella ANIMALS precedente è una tabella virtuale creata usando snowflake Connection come indicato in precedenza
- Verrà visualizzato un errore se la connessione Snowflake viene creata direttamente in un'app Canvas, come illustrato nello screenshot seguente
Annotazioni
- 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.
- 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 |