Fornire una query di origine OData in fase di esecuzione

Si applica a: SQL Server SSIS Integration Runtime in Azure Data Factory

È possibile modificare la query di origine OData in fase di esecuzione aggiungendo un'espressione alla proprietà [Origine OData].[Query] dell'attività Flusso di dati.

Le colonne restituite devono essere le stesse restituite in fase di progettazione. In caso contrario, al momento dell'esecuzione del pacchetto si verifica un errore. Assicurarsi di specificare le stesse colonne (nello stesso ordine) quando si utilizza l'opzione query $select. Un'alternativa più sicura all'uso dell'opzione $select consiste nel deselezionare le colonne non desiderate direttamente dall'interfaccia utente del componente di origine.

Sono disponibili alcune modalità differenti per impostare dinamicamente il valore di query in fase di esecuzione. Ecco alcuni dei metodi più comuni.

Specificare la query come parametro

La procedura seguente mostra come esporre la query usata da un componente di origine OData come parametro del pacchetto.

1. Fare clic con il pulsante destro del mouse sull'attività Flusso di dati e selezionare l'opzione Parametrizzare…

2. Nella finestra di dialogo Imposta parametri selezionare [<nome del componente di origine OData>].[Query] per Proprietà.

3. Scegliere se creare un nuovo parametro o usare un parametro esistente.

4. Se si seleziona Crea nuovo parametro:

   1. Immettere un nome e una descrizione per il parametro.

   2. Specificare il valore predefinito per il parametro.

   3. Specificare l' ambito (pacchetto o progetto) per il parametro.

   4. Specificare se il parametro è obbligatorio o meno.

5. Scegliere OK per chiudere la finestra di dialogo.

Specificare la query con un'espressione

Questo metodo è utile quando si vuole creare dinamicamente la stringa di query in fase di esecuzione.

1. Selezionare l' attività Flusso di dati che contiene l' Origine OData.

2. Nella finestra Proprietà selezionare la proprietà Espressioni .

3. Fare clic sul pulsante con i puntini di sospensione (...) per visualizzare Editor espressioni di proprietà.

4. Selezionare la proprietà [Origine OData].[Query] .

5. Fare clic sul pulsante con i puntini di sospensione (...) per Espressione.

6. Immettere l' espressione.

7. Fare clic su OK.

Nota

Quando si segue questo approccio, è necessario assicurarsi che i valori impostati siano correttamente codificati in URL. Alla ricezione di valori dall'input utente, ad esempio l'impostazione di singoli valori di opzioni query da un parametro, è necessario assicurarsi che i valori siano convalidati per evitare potenziali attacchi SQL injection.