SQL Server

Microsoft SQL Server è un sistema di gestione di database relazionale sviluppato da Microsoft. Connettersi a SQL Server per gestire i dati. È possibile eseguire varie azioni, ad esempio creare, aggiornare, ottenere ed eliminare in righe di una tabella.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate
App per la logica	Normale	Tutte le aree di App per la logica
Power Apps	Di alta qualità	Tutte le aree di Power Apps
Power Automate	Di alta qualità	Tutte le aree di Power Automate

Metadati del connettore
Editore	Microsoft

Approfondimento del connettore

Questo articolo descrive le operazioni per il connettore gestito di SQL Server, disponibile per App per la logica di Azure, Power Automate e Power Apps. Il connettore predefinito di SQL Server è disponibile solo per i flussi di lavoro dell'app per la logica Standard in App per la logica di Azure.

• Per altre informazioni su questo connettore in Power Apps, vedere Connettersi a SQL Server da Power Apps.
• Per altre informazioni sul connettore predefinito di SQL Server e sul connettore gestito in App per la logica di Azure, vedere Connettersi ai database SQL dai flussi di lavoro in App per la logica di Azure.

Authentication

Se si desidera creare connessioni non Microsoft Entra ID (Microsoft Entra ID), usare l'opzione di autenticazione della stringa di connessione. Assicurarsi di specificare gli stessi valori Nome server e Nome database definiti nella connessione.

Autenticazione dell'ID Microsoft Entra

Limitazioni note con l'autenticazione di Microsoft Entra ID

A causa delle limitazioni correnti della pipeline di autenticazione, gli utenti guest di Microsoft Entra ID non sono supportati per le connessioni MICROSOFT Entra ID a SQL Server. Per risolvere questo problema, usare invece l'autenticazione di SQL Server o l'autenticazione di Windows.

Abilitare l'autenticazione di Microsoft Entra ID per SQL Server

1. Configurare ed effettuare il provisioning dell'account come membro di SQL Microsoft Entra ID (Microsoft Entra ID). Per altre informazioni, vedere Configurare e gestire l'autenticazione con l'ID Entra di Microsoft con Azure SQL.

2. Nel server SQL configurare l'amministratore di Microsoft Entra ID.

   1. Nel portale di Azure passare al server SQL in cui si vuole abilitare l'autenticazione di Microsoft Entra ID.
   2. Nel menu delle risorse di SQL Server, in Impostazioni, selezionare Microsoft Entra ID.
   3. Nella barra degli strumenti del riquadro ID Di Microsoft Entra selezionare Imposta amministratore.
   4. Trovare e selezionare un account utente microsoft Entra ID nel tenant corrente per renderli un amministratore del server. Salvare le modifiche.

3. Nel tenant di Microsoft Entra ID creare e registrare un'applicazione Microsoft Entra ID per l'accesso al database SQL. Per altre informazioni, vedere SQL Server - Configurare l'autenticazione di Microsoft Entra ID.

   1. Nel portale di Azure passare al tenant microsoft Entra ID in cui si vuole creare l'applicazione Microsoft Entra ID.

   2. Nel menu del tenant, in Gestisci, selezionare Registrazioni app>Nuova registrazione.

   3. Nel riquadro Registra un'applicazione specificare un nome per l'applicazione. Tenere presente questo nome in modo che in un secondo momento sia possibile creare un utente e concedere l'accesso al ruolo al database SQL.

   4. Al termine, selezionare Registra per creare l'applicazione Microsoft Entra ID.

   5. Nel riquadro Registrazioni app selezionare la nuova applicazione Microsoft Entra ID. Nel menu dell'applicazione selezionare Certificati e segreti>Nuovo segreto client.

   6. Specificare una descrizione per il segreto e selezionare una scadenza.

4. Accedere al server SQL e al database con le credenziali per l'account utente microsoft Entra ID configurato come amministratore del server.

5. Nel database SQL creare un utente indipendente per rappresentare l'applicazione Microsoft Entra ID. Questo passaggio richiede Microsoft SQL Server Management Studio (SSMS).

   I passaggi seguenti assegnano i ruoli di db_datareader e db_datawriter all'applicazione Microsoft Entra ID con il nome example-Azure-AD-application-name. Quando si eseguono i comandi specificati, ricordarsi di sostituire example-Azure-AD-application-name con il nome per l'applicazione Microsoft Entra ID e assegnare i ruoli necessari per le proprie esigenze.

   1. Avviare SSMS e connettersi al server SQL in cui l'applicazione Microsoft Entra ID accederà.

   2. In Autenticazione usare Active Directory - Universale con supporto MFA e l'account ID Microsoft Entra configurato come amministratore del server.

   3. In Esplora oggetti espandere la cartella Database .

   4. Trovare il database, aprire il menu di scelta rapida del database e selezionare Nuova query.

   5. Nella finestra di query eseguire il comando seguente per collegare l'applicazione Microsoft Entra ID a un nuovo utente nel database:

      CREATE USER [example-Azure-AD-app-name] FROM EXTERNAL PROVIDER
      

   6. Cancellare la finestra di query. Eseguire quindi il comando seguente per assegnare il db_datareader ruolo all'applicazione Microsoft Entra ID:

      ALTER ROLE db_datareader ADD MEMBER [example-Azure-AD-application-name]
      

   7. Ripetere il passaggio precedente per assegnare il db_datawriter ruolo all'applicazione Microsoft Entra ID:

      ALTER ROLE db_datawriter ADD MEMBER [example-Azure-AD-application-name]
      

Autenticazione identità gestita

Attualmente, solo App per la logica di Azure supporta l'autenticazione dell'identità gestita per il connettore SQL Server.

Autenticazione di un'entità servizio

Configurare l'identità gestita nell'app per la logica

1. Nel portale di Azure passare alla risorsa dell'app per la logica.

2. Abilitare l'identità assegnata dal sistema o l'identità assegnata dall'utente. Se non si ha un'identità assegnata dall'utente, è prima necessario creare tale identità. Per altre informazioni, vedere Autenticare l'accesso alle risorse di Azure con identità gestite in App per la logica di Azure.

3. Se è stata selezionata l'identità assegnata dall'utente, assicurarsi di aver aggiunto tale identità alla risorsa dell'app per la logica.

   1. Nel portale di Azure passare alla risorsa dell'app per la logica in cui si vuole usare l'identità gestita.
   2. Nel menu di spostamento dell'app per la logica, in Impostazioni selezionare Identità.
   3. Nella scheda Assegnata dall'utente selezionare Aggiungi.
   4. Selezionare l'identità gestita da usare e selezionare Aggiungi.

Configurare SQL Server per l'autenticazione dell'identità gestita

1. Nel server SQL configurare l'amministratore di Microsoft Entra ID.

   1. Nel portale di Azure passare al server SQL in cui si vuole abilitare l'autenticazione di Microsoft Entra ID.
   2. Nel menu delle risorse di SQL Server, in Impostazioni, selezionare Microsoft Entra ID.
   3. Nella barra degli strumenti del riquadro ID Di Microsoft Entra selezionare Imposta amministratore.
   4. Trovare e selezionare un account utente microsoft Entra ID nel tenant corrente per renderli un amministratore del server. Salvare le modifiche.

2. Nel database SQL creare un utente indipendente per rappresentare l'identità gestita. Questo passaggio richiede Microsoft SQL Server Management Studio (SSMS).

   La procedura seguente assegna il ruolo di db_datareader a un'identità gestita con il nome example-managed-identity-name. Quando si eseguono i comandi specificati, ricordarsi di sostituire example-managed-identity-name con il nome per l'identità gestita e assegnare il ruolo corretto per le proprie esigenze. Ad esempio, db_datareader non è possibile eseguire operazioni di scrittura.

   1. Avviare SSMS e connettersi al server SQL in cui l'identità gestita accederà.

   2. In Autenticazione usare Active Directory - Universale con supporto MFA e l'account ID Microsoft Entra configurato come amministratore del server.

   3. In Esplora oggetti espandere la cartella Database .

   4. Trovare il database, aprire il menu di scelta rapida del database e selezionare Nuova query.

   5. Nella finestra di query eseguire il comando seguente per collegare l'identità gestita a un nuovo utente nel database:

      CREATE USER [example-managed-identity-name] FROM EXTERNAL PROVIDER
      

   6. Cancellare la finestra di query. Eseguire quindi il comando seguente per assegnare un ruolo all'identità di gestione:

      ALTER ROLE db_datareader ADD MEMBER [example-managed-identity-name]
      

      Annotazioni

      Se si assegnano ruoli all'identità gestita a livello di database, l'identità non avrà gli ambiti necessari per elencare tutti i database. Quando si seleziona dall'elenco Nome database in un trigger o un'azione SQL, verrà visualizzato un errore simile all'esempio seguente:

      Couldn't retrieve values. Error code: 'Unauthorized', Message: 'Credentials are missing or not valid'.
      Inner exception: The credentials provided for the SQL source are invalid
      

      Per risolvere il problema, sono disponibili le opzioni seguenti:

      • Assegnare un ruolo a livello di server in grado di elencare tutti i database all'identità gestita.
      • Nel trigger o nell'azione SQL immettere il nome del database usando l'opzione Immetti valore personalizzato .

Per altre informazioni, vedere la documentazione seguente:

• Autenticare l'accesso alle risorse di Azure usando identità gestite in App per la logica di Azure
• Esercitazione: Usare un'identità gestita assegnata dal sistema per una macchina virtuale Windows per accedere ad Azure SQL
• Configurare e gestire l'autenticazione di Microsoft Entra ID con Azure SQL
• Ruoli a livello di database
• Ruoli a livello di server

Supporto di Rete virtuale

Quando il connettore viene usato in un ambiente Power Platform collegato a una rete virtuale, si applicano le limitazioni:

• Le azioni seguenti sono le uniche azioni supportate:

  • Elimina riga (V2)
  • Eseguire una query SQL (V2)
  • Ottenere la riga (V2)
  • Ottenere righe (V2)
  • Ottenere tabelle (V2)
  • Inserisci riga (V2)
  • Aggiorna riga (V2)
  • Eseguire la stored procedure (V2)

• Qualsiasi azione all'esterno di questo elenco restituirà un errore "403 Non autorizzato"

• Il gateway dati locale non è supportato

• Quando si usa l'autenticazione integrata di Microsoft Entra ID, digitare manualmente il nome del database come valore personalizzato

Problemi noti e limitazioni con le azioni

Breve descrizione	Operations	Descrizione lunga
Ottenere risultati deterministici in un output dell'azione	Ottenere righe (V2)	L'utilizzo del Order By parametro è consigliato per ottenere risultati deterministici nell'output dell'azione. Se Order By non viene specificato, le chiavi primarie o le chiavi univoche vengono usate da SQL Server per impostazione predefinita. I risultati non deterministici possono causare problemi, ad esempio la duplicazione di record nell'output dell'azione quando la paginazione è abilitata. Le viste SQL non supportano la chiave primaria, ovvero la limitazione di SQL Server.
Eseguire un supporto limitato di query SQL	Eseguire una query SQL (V2)	Non supportato per SQL Server locale.
Requisiti CRUD generali	Ottenere la riga (V2) Ottenere righe (V2) Aggiorna riga (V2) Elimina riga (V2)	I valori stringa verranno tagliati nel caso dell'utilizzo dell'istanza di SQL di Azure. Pertanto, le stringhe vuote verranno convertite in stringhe vuote. Per le operazioni INSERT e UPDATE, il connettore restituirà le righe aggiornate. È quindi necessario che la connessione disponga dell'autorizzazione per leggere i dati anche da SQL Server. Per le operazioni seguenti è necessaria una chiave primaria: - GetItem - PatchItem - DeleteItem
Supporto dei parametri di trasformazione aggregazione	Ottenere righe (V2)	Sono supportate solo le trasformazioni aggregazioni seguenti: - filter: consente di filtrare il set di input. Supporta le stesse espressioni di $filter. Esempio: filter(ColName1 eq 1). - aggregate: consente l'aggregazione usando uno dei metodi seguenti: average, max, minsumcountdistinct. Esempio: aggregate(ColName2 with max as MaxValue). È possibile combinare diversi operatori separati da barre per esprimere che vengono applicate consecutivamente. Ciò significa che il risultato di ogni trasformazione è l'input della trasformazione successiva. Esempio: filter(ColName1 eq 4)/aggregate(ColName2 with sum as MaxWorkItemId).
Override del tipo di dati del parametro formale durante l'esecuzione di una query SQL	Eseguire una query SQL [DEPRECATO] Eseguire una query SQL (V2)	Il tipo di dati immesso durante la definizione di un parametro formale in una query SQL potrebbe essere sottoposto a override perché l'implementazione sottostante del connettore determina il tipo tramite il valore fornito del parametro.
L'operatore IN che usa parametri formali richiede che i valori passati vengano definiti separatamente	Eseguire una query SQL (V2)	Quando si usano parametri formali con l'operatore IN, tutti i valori passati devono essere definiti separatamente anziché come un singolo parametro formale che contiene più valori separati da virgole. Esempio: SELECT * FROM tableName WHERE columnName IN (@formalParameterA, @formalParameterB, @formalParameterC).
Errore durante l'uso del database Azure Sql DataWareHouse	Inserisci riga (V2)	L'uso del database Azure SQL Datawarehouse in Power Apps genera un errore a causa di una mancata corrispondenza della sintassi nell'esecuzione del connettore nel database. Creare un flusso con il connettore Azure SQL Datawarehouse in Power Automate, attivarlo da PowerApps o formare una query e usarlo nell'azione Esegui una query SQL (V2).

Problemi noti e limitazioni con i trigger

Annotazioni

La disattivazione e l'attivazione di un flusso non reimpostano lo stato del trigger.

Breve descrizione	Operations	Descrizione lunga
Modificare un elemento: operazioni di riga	Quando un elemento viene modificato (V2)	Genera sia operazioni di riga INSERT che UPDATE.
Modificare un elemento: requisiti di colonna	Quando un elemento viene modificato (V2)	È necessaria una colonna ROWVERSION.
Creare un elemento: requisito della colonna	Quando viene creato un elemento (V2)	È necessaria una colonna IDENTITY.
Creare un elemento	Quando viene creato un elemento (V2)	Usare il valore della colonna Identity della riga inserita più recente come soglia (stato trigger) per identificare le righe appena inserite in un secondo momento. La logica presuppone che l'identità di ogni nuova riga sia maggiore di quella precedente. Pertanto, nel caso in cui la sequenza di identità venga reimpostata per una tabella a causa del troncamento esplicito di t-sql o del troncamento della tabella, la logica del trigger ignorerà le nuove righe per il flusso esistente. Esistono due soluzioni alternative diverse: per prima cosa, è possibile reimpostare lo stato del trigger del flusso aggiornando la scheda di azione del trigger (ad esempio, rinominarla, aggiornare i parametri o aggiungere una nuova connessione) e salvare le modifiche. In alternativa, è possibile ripristinare la sequenza di identità della tabella di destinazione usando l'approccio seguente.

Problemi noti e limitazioni generali

• L'inserimento e l'aggiornamento a una tabella non funzioneranno se nella tabella è stato definito un trigger lato SQL Server.

  Per risolvere il problema, sono disponibili le opzioni seguenti:

  • Usare una stored procedure o una query nativa.
  • Rimuovere il trigger dalla tabella SQL.

• Le limitazioni seguenti si applicano all'uso del connettore SQL con un server SQL locale:

  • La versione minima supportata per SQL Server locale è SQL Server 2005.
  • Il limite di dimensioni della richiesta è di 2 MB tramite SQL Server locale.
  • Il limite di dimensioni della risposta è 8 MB fino a SQL Server locale.

• Le limitazioni seguenti si applicano alla chiamata di una stored procedure in un server SQL locale tramite un gateway:

  • I valori di output per OUTPUT i parametri non vengono restituiti. È comunque possibile specificare i valori di input per OUTPUT i parametri.
  • Il valore ResultSets è Untyped.
  • Il valore restituito non è disponibile.
  • Viene restituito solo il primo set di risultati.
  • Gli schemi di Dynamics non sono supportati per i set di risultati.

• I tipi di dati seguenti non possono essere usati come predicati delle opzioni di query:

  • date
  • datetime
  • datetime2
  • smalldatetime

• L'impostazione di Force Encryption non è supportata. Per impostazione predefinita, il database SQL e l'istanza gestita di SQL proteggono i dati crittografando i dati in movimento con Transport Layer Security (TLS). Per altre informazioni, vedere Panoramica della sicurezza di Azure SQL.

• Il supporto di più set di risultati è attualmente limitato per l'esecuzione di query native di SQL. Vengono restituiti solo i set di risultati, fino al primo set di risultati vuoto.

  Per risolvere il problema, usare stored procedure.

• Dopo l'esecuzione di query SQL e stored procedure, lo schema del set di risultati deve contenere nomi di colonna univoci non vuoti.

• Per qualsiasi operazione all'interno della stored procedure che restituisce alcuni set di risultati, ad esempio qualsiasi istruzione interna SELECT , lo schema del set di risultati deve contenere nomi di colonna univoci non vuoti.

• Se il tempo di esecuzione supera 110 secondi per una query SQL o una stored procedure, si verifica il timeout delle azioni.

  In App per la logica di Azure risolvere questa limitazione e informazioni su come eseguire stored procedure con esecuzione prolungata, vedere Stored procedure SQL a esecuzione prolungata in App per la logica.

• In App per la logica di Azure è possibile accedere all'endpoint privato in SQL Server solo dall'interno di un ambiente del servizio di integrazione (ISE). Per altre informazioni, vedere Accesso alle reti virtuali di Azure.

• Quando si crea una query con molti filtri, può verificarsi l'errore seguente: "L'albero della sintassi delle query OData ha superato il limite di numero di nodi '100'. Provare a semplificare le espressioni dei parametri di query OData". Per evitare questo problema, ottimizzare le condizioni di filtro per ridurre il numero , ad esempio usando intervalli.

• Non è consigliabile archiviare grandi quantità di dati (più di 30 megabyte) nei campi della tabella di destinazione (e.g. xml o tipi di dati di testo). Può causare una riduzione delle prestazioni significamt di azioni e trigger, causando 504 errori di timeout. Usare il parametro 'Select Query' per includere solo campi relativamente piccoli ed evitare campi di dati di output di grandi dimensioni. In alternativa, usare archivi file specializzati, ad esempio Archiviazione BLOB di Azure.

• Le operazioni CRUD non sono supportate per le origini di Azure Synapse a causa della mancanza di supporto della clausola OUTPUT. È consigliabile usare invece il connettore Azure SQL Data Warehouse dedicato.

• Le visualizzazioni dello strumento di spostamento di Power Platform e App per la logica sono limitate a un elenco di 10.000 tabelle.

• Lo schema del database non conforme agli identificatori standard OData non è supportato (il nome della colonna a partire dal numero, contenente il carattere della coppia di surrogati e così via). I clienti possono usare una vista per astrarre il nome delle colonne oppure per gestire l'uso di caratteri di piano supplementari separati dallo schema del database, vedere Aggiungere una proprietà estesa a una colonna in una tabella.

• Quando si usa il connettore SQL come origine dati per le tabelle virtuali, i valori del server e del database devono corrispondere tra il set di dati di origine e la connessione in uso. Quando si usa l'autenticazione SQL, i valori del set di dati possono essere impostati su predefinito, per impostazione predefinita, perché la connessione conterrà già valori di server e database. Se i valori di connessione del set di dati sono indicati in modo esplicito, devono corrispondere a quelli della connessione in caso contrario, ad esempio "Si è verificato un errore. Non siamo riusciti ad aprire il tavolo. Provare a ricaricare o riaprire." o "origine dati non valida" potrebbe verificarsi.

• Quando si verificano modifiche allo schema nelle visualizzazioni usate nei flussi di Power Automate, i trigger potrebbero non essere attivati fino a quando non viene creata una nuova connessione nella visualizzazione aggiornata. L'aggiornamento della connessione non è sufficiente solo per reimpostare il trigger rispetto alle visualizzazioni aggiornate.

• Il protocollo TDS (Tabular Data Stream) 8.0 non è attualmente supportato dal connettore SQL.

Limiti speciali per la limitazione

• In casi diversi, il connettore SQL ha limiti di limitazione diversi. Nella tabella seguente le operazioni native includono stored procedure SQL e query SQL. CRUD è l'acronimo di operazioni di creazione, lettura, aggiornamento ed eliminazione.

• Oltre ai limiti seguenti, la limitazione del livello connectionID viene applicata anche in base al tempo totale impiegato dalle richieste precedenti in un determinato periodo di tempo.

Servizio	Ambiente	Operations	Nome	Chiamate	Periodo di rinnovo (secondi)
App per la logica e Power Automate	Ambiente condiviso	Native	Chiamate API per connessione	500	10
App per la logica e Power Automate	Ambiente condiviso	CRUD	Chiamate API per connessione	100	10
App per la logica e Power Automate	Ambiente condiviso	Native	Chiamate simultanee per connessione	200	-
App per la logica e Power Automate	Ambiente condiviso	CRUD	Chiamate simultanee per connessione	125	-
Power Apps (applicazioni potenti)	Ambiente condiviso	Tutti	Chiamate API per utente	300	30
Power Apps (applicazioni potenti)	Ambiente condiviso	Tutti	Chiamate simultanee per connessione	125	-

Annotazioni

Le chiamate simultanee sono il numero di richieste in corso che una determinata connessione può effettuare. Ad esempio, con le chiamate native di App per la logica di Azure, una singola connessione può effettuare 200 chiamate simultanee. Eventuali chiamate successive restituiscono un errore 429 se tutte le 200 chiamate sono ancora in esecuzione. Non esiste alcun limite di tempo perché le chiamate possono richiedere una quantità arbitraria di tempo. Tuttavia, il punto del limite di chiamate consiste nel impedire troppe query con esecuzione prolungata da una singola connessione e influire negativamente su altre connessioni.

Ad esempio, se una connessione effettua 200 chiamate contemporaneamente e ogni chiamata richiede 50 secondi per l'esecuzione, tutte le altre chiamate avranno esito negativo con un errore 429 per i 50 secondi successivi. Al termine dell'esecuzione di una o più query e i risultati vengono restituiti, vengono elaborate tutte le chiamate successive.

Mapping dei tipi di dati di Power Apps

Vedere la documentazione di Power Apps SQL

Funzioni e operazioni di Power Apps delegabili a SQL Server

Vedere la documentazione relativa alla delega SQL di Power Apps

Parametri formali nelle operazioni

Eseguire una query SQL [DEPRECATO] ed Eseguire azioni di query SQL (V2) consentono l'utilizzo di parametri formali. Sono definite come coppie chiave-valore, dove key è il nome del parametro e value è il tipo di dati SQL, ad esempio INT o NVARCHAR(255). Dopo aver definito il nome e il tipo di dati, viene visualizzato un nuovo campo di input per il valore.

Eseguire la migrazione delle operazioni V1 alle operazioni V2 equivalenti

Seguire questa procedura per eseguire la migrazione da un'operazione V1 all'equivalente V2.

Importante

Prima di avviare la migrazione, salvare sempre una copia dell'app per la logica, del flusso di Power Automate o di Power App per avere un backup.

Annotazioni

Tutte le operazioni V2 hanno due parametri aggiuntivi: Server Name, e Database Name. In questo modo, le operazioni V2 supportano le autenticazioni di MICROSOFT Entra ID.

Tipo di operazione	Operazione V1	Equivalente all'operazione V2
Action	Elimina riga [DEPRECATO]	Elimina riga (V2)
Action	Eseguire una query SQL [DEPRECATO]	Eseguire una query SQL (V2)
Action	Eseguire una stored procedure	Eseguire la stored procedure (V2)
Action	Ottenere la riga [DEPRECATO]	Ottenere la riga (V2)
Action	Ottenere righe [DEPRECATO]	Ottenere righe (V2)
Action	Inserisci riga [DEPRECATO]	Inserisci riga (V2)
Action	Elenca le tabelle esposte dalla connessione [DEPRECATO]	Ottenere tabelle (V2)
Action	Aggiorna riga [DEPRECATO]	Aggiorna riga (V2)
Attivatore	Quando viene creato un elemento [DEPRECATO]	Quando viene creato un elemento (V2)
Attivatore	Quando un elemento viene modificato [DEPRECATO]	Quando un elemento viene modificato (V2)

Identificare le azioni V1

Power Automate

Per le operazioni di Power Automate, aprire l'operazione di Code View SQL Server e controllare il host.operationId valore. Se il valore corrisponde a uno degli ID operazione di SQL Server V1 elencati in precedenza, tale operazione deve essere migrata all'equivalente V2.

Ad esempio, PatchItem l'operazione deve essere migrata a PatchItem_V2.

Logic Apps (App di automazione dei flussi di lavoro)

Per ottenere una panoramica delle app per la logica che contengono almeno un'operazione di SQL Server V1:

1. Aprire il portale di Azure

2. Aprire Azure Resource Graph Explorer

3. Immettere l'ID sottoscrizione nel segnaposto ed eseguire la query seguente per ottenere un riepilogo delle app per la logica che richiedono attenzione e il numero di azioni di SQL Server V1 in ognuna di esse.

   • Script di Azure Resource Graph Explorer per identificare app per la logica con azioni V1.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend actionsJson=propertiesJson["definition"]["actions"]
     | mv-expand actionsJson
     | where notnull(actionsJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(actionsJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend actionConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(actionsJson))
     | where notnull(actionConnectionName)
     | parse actionConnectionName with "@parameters('$connections')['"parsedActionConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedActionConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, actionsJson
     | summarize v1ActionCount = count() by resourceGroup, logicAppName = name
     

   • Script di Azure Resource Graph Explorer per identificare app per la logica con trigger V1.

     resources
     | where subscriptionId == "<subscription-id>"
     | where type == "microsoft.logic/workflows"
     | extend propertiesJson=parse_json(properties)
     | extend triggersJson=propertiesJson["definition"]["triggers"]
     | mv-expand triggersJson
     | where notnull(triggersJson)
     | extend path=extract("\"path\":\"(.*?)\"", 1, tostring(triggersJson))
     | where notnull(path) and path startswith "/datasets/default/"
     | extend triggerConnectionName=extract("\"connection\":{\"name\":\"(.*?)\"}", 1, tostring(triggersJson))
     | where notnull(triggerConnectionName)
     | parse triggerConnectionName with "@parameters('$connections')['"parsedTriggerConnectionName"']['connectionId']"
     | extend tmpConnection = propertiesJson["parameters"]["$connections"]["value"][parsedTriggerConnectionName]
     | where notnull(tmpConnection)
     | extend connectionId=extract("\"id\":\"(.*?)\"", 1, tostring(tmpConnection))
     | where notnull(connectionId) and connectionId endswith "/managedApis/sql"
     | project id, name, resourceGroup, triggersJson
     | summarize v1TriggerCount = count() by resourceGroup, logicAppName = name
     

Eseguire la migrazione alle operazioni V2 nell'esperienza utente

Eseguire la migrazione di App per la logica e automazione di Power Automate

1. Aprire il flusso app per la logica o Power Automate che contiene l'azione V1.

2. Aggiungere un'azione subito prima o dopo l'azione V1 da aggiornare.

   

3. Fare clic sul connettore SQL Server e cercare l'equivalente V2 dell'azione di cui si esegue la migrazione.

   

4. Selezionare la connessione da usare nell'azione V2.

   Suggerimento

   Le azioni V2 supportano i tipi di autenticazione Microsoft Entra ID. App per la logica supporta anche App per la logica di Azure supporta l'autenticazione dell'identità gestita nelle azioni V2.

   Per altre informazioni, vedere la sezione Autenticazione .

5. Immettere il nome del server.

   • Se si usa Windows Authentication o SQL Server Authentication, selezionare il nome del server dall'elenco a discesa.

     

   • Se si usa Service principalo Microsoft Entra IDManaged Identity il tipo di autenticazione, fare clic su "Immettere un valore personalizzato" nell'elenco a discesa, quindi immettere il nome del server.

     

6. Immettere il database selezionandolo nell'elenco a discesa.

   

7. Immettere i parametri rimanenti in modo che corrispondano all'azione V1.

8. Dopo aver completato la configurazione dell'azione V1, eliminare l'azione V2.

   

   Importante

   L'eliminazione dell'azione V1 causerà l'eliminazione di tutto il contenuto dinamico dalla versione 1; Sarà necessario aggiungere nuovamente il contenuto dinamico V2.

Eseguire la migrazione di Power Apps

1. Aprire l'app che deve essere aggiornata.

2. Eliminare tutte le origini dati SQL.

   Annotazioni

   Le formule che usano le origini dati eliminate visualizzeranno un errore, è previsto e verranno risolte nei passaggi successivi.

   

3. Aprire la scheda Funzionalità future in Impostazioni e digitare "SQL" nella casella di ricerca. Verrà visualizzata la funzionalità "Abilita connettore Microsoft SQL Server avanzato".

   

4. Attivare la funzionalità "Abilita connettore Microsoft SQL Server avanzato".

   Annotazioni

   Questa funzionalità è attivata per impostazione predefinita per tutte le nuove app Power Apps.

   

5. Lettura dell'origine dati.

   

6. Verificare il comportamento dell'app, specialmente nelle tabelle che gestiscono i tipi di dati DateTime.

7. Salvare l'app.

Eseguire la migrazione delle operazioni tramite visualizzazione codice in App per la logica di Azure

Per scenari più complessi, è possibile eseguire la migrazione delle azioni aggiornando la definizione del flusso di lavoro.

1. Identificare il nome delle operazioni (trigger e/o azioni) di cui è necessario eseguire la migrazione nell'app per la logica.

2. Aprire la finestra di progettazione dell'app per la logica da modificare e fare clic su "Visualizzazione codice".

   

3. Per ogni azione di cui è necessario eseguire la migrazione:

   1. Trovare l'azione o la proprietà del percorso del trigger
   2. Sostituire /datasets/default/ nella proprietà path con /v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/.

4. Dopo aver aggiornato tutte le operazioni, fare clic su "Progettazione".

   

5. Verificare che la migrazione di tutte le operazioni sia stata eseguita correttamente.

   • Il nome del server e del database deve essere popolato con i valori della connessione.
   • Tutti gli altri parametri devono anche essere popolati.

   

6. Salvare e testare l'app per la logica.

Suggerimento

Se necessario, dopo la migrazione delle azioni alla versione V2, è possibile aggiornare il nome e la connessione dell'operazione.

Di seguito è riportato un esempio per la migrazione di Get rows [DEPRECATED].

1. Aprire "Visualizzazione codice".

2. Trovare l'azione "Recupera righe [DEPRECATO]".

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/datasets/default/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

3. Aggiornare il segmento dei set di dati del percorso con il sostituto specificato in precedenza.

   "actions": {
     "Get_rows_[DEPRECATED]": {
       "inputs": {
         "host": {
           "connection": {"name": "..."},
           "method": "get",
           "path": "/v2/datasets/@{encodeURIComponent(encodeURIComponent('default'))},@{encodeURIComponent(encodeURIComponent('default'))}/tables/.../items"
         },
         "runAfter": {},
         "type": "ApiConnection"
       }
     }
   }
   

4. Fare clic su "Progettazione" per tornare alla visualizzazione iniziale e verificare che l'azione sia stata popolata correttamente.

Eseguire la migrazione delle operazioni tramite la modifica della definizione del flusso

1. Identificare il nome delle operazioni (trigger e/o azioni) di cui è necessario eseguire la migrazione nell'app per la logica.

2. Esportare il flusso come pacchetto (ZIP).

   

3. Estrarre il file ZIP.

4. Aprire la cartella in cui è stato estratto ZIP.

5. Passare a Microsoft.Flow, quindi flows, quindi alla cartella denominata GUID.

6. Aprire il file definition.json in un editor di testo.

   • Per migliorare la leggibilità, formattare il codice JSON.

7. Per ogni azione di cui è necessario eseguire la migrazione:

   1. Trovare l'azione o la proprietà del trigger

   2. Aggiornare inputs.host.operationId la proprietà all'equivalente V2. È possibile trovare il valore nella documentazione dell'operazione.

      

   3. Aggiungere a inputs.parameters due proprietà:

      • server con valore default
      • database con valore default

8. Salvare il file definition.json

9. Tornare alla posizione in cui si trovano manifest.json e Microsoft.Flow

10. Selezionare Sia Microsoft.Flow che manifest.jsone comprimere in un file ZIP.

    Importante

    Assicurarsi che il nuovo file ZIP abbia esattamente lo stesso file e la stessa struttura di cartelle del file ZIP originale.

    La cartella Microsoft.Flow e il file manifest.json devono trovarsi nella radice del nuovo file ZIP. Se non si ha la stessa struttura, si verificheranno errori durante il caricamento del pacchetto.

    

11. Passare ai flussi in Power Automate.

12. Importare il flusso aggiornato importando il pacchetto. Selezionare il file ZIP appena creato e caricare il pacchetto.

    

13. Selezionare l'installazione di importazione (importare/crearne una nuova) e selezionare le connessioni che verranno usate dal flusso.

14. Al termine dell'importazione, aprire il flusso nuovo/aggiornato.

15. Verificare che le azioni siano state aggiornate

• Il nome del server e del database deve essere popolato con i valori della connessione.

• Tutti gli altri parametri devono anche essere popolati.

  

Suggerimento

Se necessario, dopo la migrazione delle azioni alla versione V2, il nome e la connessione dell'operazione possono essere aggiornati nell'esperienza utente.

Di seguito è riportato un esempio per eseguire una query SQL [DEPRECATO].

1. Aprire "Visualizzazione codice".

2. Trovare l'azione "Esegui una query SQL [DEPRECATO]".

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery"
         },
         "parameters": {
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   

3. Aggiornare l'ID operazione con l'ID operazione V2 equivalente, quindi aggiungere i parametri del server e del database con il default valore indicato in precedenza.

   "actions": {
     "Execute_a_SQL_query_[DEPRECATED]": {
       // ...
       "inputs": {
         "host": {
           // ...
           "operationId": "ExecutePassThroughNativeQuery_V2"
         },
         "parameters": {
           "server": "default",
           "database": "default",
           "query/query": "SELECT * from [dbo].[SampleTable] WHERE AnyId = 42",
         },
         // ..
       }
     }
   }
   
   

Importante

Le connessioni Microsoft Entra ID Integrated (Azure Commercial) sono disabilitate negli ambienti GCC (US Government) per impostazione predefinita. Per abilitare questi tipi di connessioni, l'impostazione Connetti ad Azure Commercial deve essere abilitata nell'interfaccia di amministrazione di Power Platform da un amministratore tenant.

L'attivazione di questa impostazione consente le connessioni alle risorse in Azure Commercial che operano e inviano dati al di fuori del limite di conformità di Power Platform US Government. Questo viene utilizzato specificamente per consentire l'accesso alle risorse commerciali dalle versioni cloud GCC dei connettori di Power Platform.

Microsoft Entra ID Integrated (Azure Commercial) è l'unico tipo di autenticazione che funziona dagli ambienti GCC (US Government) alle risorse commerciali di Azure.

Autenticazione commerciale di Azure disabilitata per

L'impostazione Connetti ad Azure Commercial nell'interfaccia di amministrazione di Power Platform:

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Autenticazione del certificato client	Specificare le credenziali dell'ID Entra di Microsoft usando il certificato PFX e la password	Tutte le aree geografiche	Condivisibile
Microsoft Entra ID integrato	Usare Microsoft Entra ID per accedere al database SQL.	Tutte le aree tranne US Government (GCC)	Non condivisibile
Microsoft Entra ID Integrated (Azure Commercial)	Usare Microsoft Entra ID per accedere al database SQL in Azure Commercial.	Solo US Government (GCC)	Non condivisibile
Microsoft Entra ID Integrated (Azure per enti pubblici)	Usare Microsoft Entra ID per accedere al database SQL in Azure per enti pubblici.	Solo US Government (GCC)	Non condivisibile
Entità servizio (applicazione Microsoft Entra ID)	Usare l'applicazione Microsoft Entra ID per accedere al database SQL.	Tutte le aree geografiche	Condivisibile
Autenticazione di SQL Server	Usare un nome account e una password per accedere al database SQL.	Tutte le aree geografiche	Condivisibile
Autenticazione di Windows	Usare un nome e una password dell'account Microsoft Entra ID locali per accedere al database SQL.	Tutte le aree geografiche	Condivisibile
Autenticazione di Windows (non condivisa)	Usare un nome e una password dell'account Microsoft Entra ID locali per accedere al database SQL.	Tutte le aree geografiche	Non 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

Autenticazione del certificato client

ID autenticazione: certOauth

Applicabile: tutte le aree

Specificare le credenziali dell'ID Entra di Microsoft usando il certificato PFX e la password

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	ID client di per l'applicazione Microsoft Entra ID
Segreto certificato client	Certificato del Cliente	Segreto del certificato client consentito da questa applicazione	Vero

Microsoft Entra ID Integrato

ID autenticazione: oauth

Applicabile: tutte le aree tranne us government (GCC)

Usare Microsoft Entra ID per accedere al database SQL.

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.

Microsoft Entra ID Integrated (Azure Commercial)

ID autenticazione: oauthCom

Applicabile: solo US Government (GCC)

Usare Microsoft Entra ID per accedere al database SQL in Azure Commercial.

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.

Microsoft Entra ID Integrated (Azure per enti pubblici)

ID autenticazione: oauth

Applicabile: solo US Government (GCC)

Usare Microsoft Entra ID per accedere al database SQL in Azure per enti pubblici.

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.

Entità servizio (applicazione Microsoft Entra ID)

ID autenticazione: oauthSP

Applicabile: tutte le aree

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

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

Autenticazione di SQL Server

ID autenticazione: sqlAuthentication

Applicabile: tutte le aree

Usare un nome account e una password per accedere al database SQL.

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
Nome del server SQL	corda	Specificare il nome del server SQL (server[:p ort])	Vero
Nome database SQL	corda	Nome database SQL	Vero
Nome utente	securestring	Credenziali del nome utente	Vero
Parola chiave	securestring	Credenziali password	Vero
Gateway	gatewaySetting	Gateway locale (vedere https://docs.microsoft.com/data-integration/gateway per altri dettagli

Autenticazione di Windows

ID autenticazione: windowsAuthentication

Applicabile: tutte le aree

Usare un nome e una password dell'account Microsoft Entra ID locali per accedere al database SQL.

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
Nome del server SQL	corda	Specificare il nome del server SQL (server[:p ort])	Vero
Nome database SQL	corda	Nome database SQL	Vero
Nome utente	securestring	Credenziali del nome utente	Vero
Parola chiave	securestring	Credenziali password	Vero
Gateway	gatewaySetting	Gateway locale (vedere https://docs.microsoft.com/data-integration/gateway per altri dettagli	Vero

Autenticazione di Windows (non condivisa)

ID autenticazione: windowsAuthenticationNonShared

Applicabile: tutte le aree

Usare un nome e una password dell'account Microsoft Entra ID locali per accedere al database SQL.

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
Nome utente	securestring	Credenziali del nome utente	Vero
Parola chiave	securestring	Credenziali password	Vero
Gateway	gatewaySetting	Gateway locale (vedere https://docs.microsoft.com/data-integration/gateway per altri dettagli	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
Nome del server SQL	corda	Nome del server SQL	Vero
Nome database SQL	corda	Nome database SQL	Vero
Tipo di autenticazione	corda	Tipo di autenticazione per la connessione al database
Nome utente	securestring	Credenziali del nome utente	Vero
Parola chiave	securestring	Credenziali password	Vero
Gateway	gatewaySetting	Gateway locale (vedere https://docs.microsoft.com/data-integration/gateway per altri dettagli

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	10 secondi

Azioni

Aggiorna riga (V2)	Questa operazione aggiorna una riga esistente in una tabella.
Aggiorna riga [DEPRECATO]	Questa azione è stata deprecata. Usare invece Update row (V2). Questa operazione aggiorna una riga esistente in una tabella.
Elenca le tabelle esposte dalla connessione [DEPRECATO]	Questa azione è stata deprecata. Usare invece Get tables (V2). Elenca le tabelle esposte dalla connessione
Elimina riga (V2)	Questa operazione elimina una riga da una tabella.
Elimina riga [DEPRECATO]	Questa azione è stata deprecata. Usare invece Elimina riga (V2). Questa operazione elimina una riga da una tabella.
Eseguire la stored procedure (V2)	Questa operazione esegue una stored procedure.
Eseguire una query SQL (V2)	Eseguire una query SQL (V2)
Eseguire una query SQL [DEPRECATO]	Questa azione è stata deprecata. Usare invece Esegui una query SQL (V2). Eseguire una query SQL
Eseguire una stored procedure	Questa operazione esegue una stored procedure.
Inserisci riga (V2)	Questa operazione inserisce una nuova riga in una tabella.
Inserisci riga [DEPRECATO]	Questa azione è stata deprecata. Usare invece Inserisci riga (V2). Questa operazione inserisce una nuova riga in una tabella.
Ottenere la riga (V2)	Questa operazione ottiene una riga da una tabella.
Ottenere la riga [DEPRECATO]	Questa azione è stata deprecata. Usare invece Get row (V2). Questa operazione ottiene una riga da una tabella.
Ottenere righe (V2)	Questa operazione ottiene righe da una tabella.
Ottenere righe [DEPRECATO]	Questa azione è stata deprecata. Usare invece Recupera righe (V2). Questa operazione ottiene righe da una tabella.
Ottenere tabelle (V2)	Questa operazione ottiene tabelle da un database.
Trasformare i dati con Power Query	Trasformare i dati usando Power Query. Nota: questa operazione non funziona quando ci si connette con l'ID Microsoft Entra di SQL.

Aggiorna riga (V2)

ID operazione:

PatchItem_V2

Questa operazione aggiorna una riga esistente in una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella
ID riga	id	True	string	Identificatore univoco della riga da aggiornare
Riga	item	True	dynamic	Riga con valori aggiornati

Restituisce

Gli output di questa operazione sono dinamici.

Aggiorna riga [DEPRECATO]

ID operazione:

PatchItem

Questa azione è stata deprecata. Usare invece Update row (V2).

Questa operazione aggiorna una riga esistente in una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella
ID riga	id	True	string	Identificatore univoco della riga da aggiornare
Riga	item	True	dynamic	Riga con valori aggiornati

Restituisce

Gli output di questa operazione sono dinamici.

Elenca le tabelle esposte dalla connessione [DEPRECATO]

ID operazione:

GetTables

Questa azione è stata deprecata. Usare invece Get tables (V2).

Elenca le tabelle esposte dalla connessione

Restituisce

Rappresenta un elenco di tabelle.

Corpo

TablesList

Elimina riga (V2)

ID operazione:

DeleteItem_V2

Questa operazione elimina una riga da una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella
ID riga	id	True	string	Identificatore univoco della riga da eliminare

Elimina riga [DEPRECATO]

ID operazione:

DeleteItem

Questa azione è stata deprecata. Usare invece Elimina riga (V2).

Questa operazione elimina una riga da una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella
ID riga	id	True	string	Identificatore univoco della riga da eliminare

Eseguire la stored procedure (V2)

ID operazione:

ExecuteProcedure_V2

Questa operazione esegue una stored procedure.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome procedura	procedure	True	string	Nome della stored procedure
Elenco di parametri	parameters	True	dynamic	Parametri di input per la stored procedure

Restituisce

Gli output di questa operazione sono dinamici.

Eseguire una query SQL (V2)

ID operazione:

ExecutePassThroughNativeQuery_V2

Eseguire una query SQL (V2)

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Query	query	True	dynamic	corpo della query

Restituisce

Gli output di questa operazione sono dinamici.

Eseguire una query SQL [DEPRECATO]

ID operazione:

ExecutePassThroughNativeQuery

Questa azione è stata deprecata. Usare invece Esegui una query SQL (V2).

Eseguire una query SQL

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Query	query	True	dynamic	corpo della query

Restituisce

Gli output di questa operazione sono dinamici.

Eseguire una stored procedure

ID operazione:

ExecuteProcedure

Questa operazione esegue una stored procedure.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome procedura	procedure	True	string	Nome della stored procedure
Elenco di parametri	parameters	True	dynamic	Parametri di input per la stored procedure

Restituisce

Gli output di questa operazione sono dinamici.

Inserisci riga (V2)

ID operazione:

PostItem_V2

Questa operazione inserisce una nuova riga in una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella
Riga	item	True	dynamic	Riga da inserire nella tabella specificata

Restituisce

Gli output di questa operazione sono dinamici.

Inserisci riga [DEPRECATO]

ID operazione:

PostItem

Questa azione è stata deprecata. Usare invece Inserisci riga (V2).

Questa operazione inserisce una nuova riga in una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella
Riga	item	True	dynamic	Riga da inserire nella tabella specificata

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere la riga (V2)

ID operazione:

GetItem_V2

Questa operazione ottiene una riga da una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella SQL
ID riga	id	True	string	Identificatore univoco della riga da recuperare

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere la riga [DEPRECATO]

ID operazione:

GetItem

Questa azione è stata deprecata. Usare invece Get row (V2).

Questa operazione ottiene una riga da una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella SQL
ID riga	id	True	string	Identificatore univoco della riga da recuperare

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere righe (V2)

ID operazione:

GetItems_V2

Questa operazione ottiene righe da una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella SQL
Trasformazione aggregazione	$apply		string	Sequenza di trasformazioni di aggregazione OData
Query di filtro	$filter		string	Query di filtro ODATA per limitare le voci restituite, ad esempio stringColumn eq 'string' OR numberColumn lt 123.
Ordina per	$orderby		string	Query ODATA orderBy per specificare l'ordine delle voci.
Ignora conteggio	$skip		integer	Numero di voci da ignorare (valore predefinito = 0).
Conteggio superiore	$top		integer	Numero totale di voci da recuperare (impostazione predefinita = all).
Selezionare query	$select		string	Campi specifici da recuperare dalle voci (impostazione predefinita = all).

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere righe [DEPRECATO]

ID operazione:

GetItems

Questa azione è stata deprecata. Usare invece Recupera righe (V2).

Questa operazione ottiene righe da una tabella.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella SQL
Trasformazione aggregazione	$apply		string	Sequenza di trasformazioni di aggregazione OData
Query di filtro	$filter		string	Query di filtro ODATA per limitare le voci restituite, ad esempio stringColumn eq 'string' OR numberColumn lt 123.
Ordina per	$orderby		string	Query ODATA orderBy per specificare l'ordine delle voci.
Ignora conteggio	$skip		integer	Numero di voci da ignorare (valore predefinito = 0).
Conteggio superiore	$top		integer	Numero totale di voci da recuperare (impostazione predefinita = all).
Selezionare query	$select		string	Campi specifici da recuperare dalle voci (impostazione predefinita = all).

Restituisce

Gli output di questa operazione sono dinamici.

Ottenere tabelle (V2)

ID operazione:

GetTables_V2

Questa operazione ottiene tabelle da un database.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database

Restituisce

Rappresenta un elenco di tabelle.

Corpo

TablesList

Trasformare i dati con Power Query

ID operazione:

SqlExecutePassThroughPowerQuery

Trasformare i dati usando Power Query. Nota: questa operazione non funziona quando ci si connette con l'ID Microsoft Entra di SQL.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
query	query		mquery	Testo query

Restituisce

Gli output di questa operazione sono dinamici.

Trigger

Quando un elemento viene modificato (V2)	Attiva un flusso quando un elemento viene modificato/inserito in SQL
Quando un elemento viene modificato [DEPRECATO]	Questa azione è stata deprecata. Usare invece Quando un elemento viene modificato (V2). Attiva un flusso quando un elemento viene modificato/inserito in SQL
Quando viene creato un elemento (V2)	Attiva un flusso quando viene creato un elemento in SQL
Quando viene creato un elemento [DEPRECATO]	Questa azione è stata deprecata. Usare invece Quando viene creato un elemento (V2). Attiva un flusso quando viene creato un elemento in SQL

Quando un elemento viene modificato (V2)

ID operazione:

GetOnUpdatedItems_V2

Attiva un flusso quando un elemento viene modificato/inserito in SQL

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella SQL
Query di filtro	$filter		string	Query di filtro ODATA per limitare le voci restituite, ad esempio stringColumn eq 'string' OR numberColumn lt 123.
Conteggio superiore	$top		integer	Numero totale di voci da recuperare (impostazione predefinita = all).
Ordina per	$orderby		string	Query ODATA orderBy per specificare l'ordine delle voci.
Selezionare query	$select		string	Campi specifici da recuperare dalle voci (impostazione predefinita = all).

Restituisce

Gli output di questa operazione sono dinamici.

Quando un elemento viene modificato [DEPRECATO]

ID operazione:

GetOnUpdatedItems

Questa azione è stata deprecata. Usare invece Quando un elemento viene modificato (V2).

Attiva un flusso quando un elemento viene modificato/inserito in SQL

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella SQL
Query di filtro	$filter		string	Query di filtro ODATA per limitare le voci restituite, ad esempio stringColumn eq 'string' OR numberColumn lt 123.
Conteggio superiore	$top		integer	Numero totale di voci da recuperare (impostazione predefinita = all).
Ordina per	$orderby		string	Query ODATA orderBy per specificare l'ordine delle voci.
Selezionare query	$select		string	Campi specifici da recuperare dalle voci (impostazione predefinita = all).

Restituisce

Gli output di questa operazione sono dinamici.

Quando viene creato un elemento (V2)

ID operazione:

GetOnNewItems_V2

Attiva un flusso quando viene creato un elemento in SQL

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del server	server	True	string	Nome di SQL Server
Nome del database	database	True	string	Nome del database
Nome della tabella	table	True	string	Nome della tabella SQL
Query di filtro	$filter		string	Query di filtro ODATA per limitare le voci restituite, ad esempio stringColumn eq 'string' OR numberColumn lt 123.
Conteggio superiore	$top		integer	Numero totale di voci da recuperare (impostazione predefinita = all).
Ordina per	$orderby		string	Query ODATA orderBy per specificare l'ordine delle voci.
Selezionare query	$select		string	Campi specifici da recuperare dalle voci (impostazione predefinita = all).

Restituisce

Gli output di questa operazione sono dinamici.

Quando viene creato un elemento [DEPRECATO]

ID operazione:

GetOnNewItems

Questa azione è stata deprecata. Usare invece Quando viene creato un elemento (V2).

Attiva un flusso quando viene creato un elemento in SQL

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome della tabella	table	True	string	Nome della tabella SQL
Query di filtro	$filter		string	Query di filtro ODATA per limitare le voci restituite, ad esempio stringColumn eq 'string' OR numberColumn lt 123.
Conteggio superiore	$top		integer	Numero totale di voci da recuperare (impostazione predefinita = all).
Ordina per	$orderby		string	Query ODATA orderBy per specificare l'ordine delle voci.
Selezionare query	$select		string	Campi specifici da recuperare dalle voci (impostazione predefinita = all).

Restituisce

Gli output di questa operazione sono dinamici.

Definizioni

Tabella

Rappresenta una tabella.

Nome	Percorso	Tipo	Descrizione
Nome	Name	string	Nome della tabella. Il nome viene usato in fase di esecuzione.
Nome visualizzato	DisplayName	string	Nome visualizzato della tabella.
Proprietà dinamiche	DynamicProperties	object	Proprietà aggiuntive della tabella fornite dal connettore ai client.

TablesList

Rappresenta un elenco di tabelle.

Nome	Percorso	Tipo	Descrizione
value	value	array of Table	Elenco di tabelle