Condividi tramite


Trasformare i dati in Smartsheet (anteprima) usando Azure Data Factory o Synapse Analytics

Applicabile a: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come iniziare una prova gratuita!

Questo articolo illustra come usare il flusso di dati per trasformare i dati in Smartsheet (anteprima). Per altre informazioni, leggere l'articolo introduttivo per Azure Data Factory o Azure Synapse Analytics.

Importante

Questo connettore è attualmente disponibile in anteprima. È possibile provarlo e inviare commenti e suggerimenti. Se si vuole accettare una dipendenza dai connettori in versione di anteprima nella propria soluzione, contattare il supporto tecnico di Azure.

Funzionalità supportate

Questo connettore Smartsheet è supportato per le funzionalità seguenti:

Funzionalità supportate IR
Flusso di dati per mapping (origine/-)

(1) Runtime di integrazione di Azure (2) Runtime di integrazione autogestito

Per un elenco degli archivi dati supportati come origini/sink, vedere la tabella Archivi dati supportati .

Creare un servizio collegato Smartsheet usando l'interfaccia utente

Usare la procedura seguente per creare un servizio collegato Smartsheet nell'interfaccia utente del portale di Azure.

  1. Passare alla scheda Gestisci nell'area di lavoro di Azure Data Factory o Synapse e selezionare Servizi collegati, quindi selezionare Nuovo:

  2. Cercare Smartsheet (anteprima) e selezionare il connettore Smartsheet (anteprima).

    Screenshot che mostra la selezione del connettore Smartsheet.

  3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

    Screenshot della configurazione per il servizio integrato Smartsheet.

Dettagli di configurazione del connettore

Le sezioni seguenti forniscono informazioni sulle proprietà usate per definire le entità della pipeline di Data Factory e Synapse specifiche di Smartsheet.

Proprietà del servizio collegato

Per il servizio collegato Smartsheet sono supportate le proprietà seguenti:

Proprietà Descrizione Obbligatorio
tipo La proprietà type deve essere impostata su Smartsheet.
apiToken Specificare un token API per Smartsheet. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro. In alternativa, fare riferimento a un segreto archiviato in Azure Key Vault.

Esempio:

{
    "name": "SmartsheetLinkedService",
    "properties": {
        "type": "Smartsheet",
        "typeProperties": {
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Mappatura delle proprietà del flusso di dati

Quando si trasformano i dati nel flusso di dati di mapping, è possibile leggere le tabelle da Smartsheet. Per altre informazioni, vedere la trasformazione dell'origine nei flussi di dati per mapping. È possibile usare un set di dati inline solo come tipo di origine.

Trasformazione della sorgente

Nella tabella seguente sono elencate le proprietà supportate dall'origine Smartsheet. È possibile modificare queste proprietà nella scheda Opzioni origine.

Nome Descrizione Obbligatorio Valori consentiti Proprietà script del flusso di dati
Tipo di entità Tipo dell'asset di dati in Smartsheet. Sì quando si usa la modalità inline sheets reports tipo di entità
Nome dell'entità Nome di un foglio o di un report in Smartsheet. Sì quando si usa la modalità inline String entityId

Esempi di script di origine Smartsheet

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'smartsheet',
	format: 'rest',
	entityId: 'Sheet1',
	entityType: 'sheets') ~> SmartsheetSource

Per un elenco degli archivi dati supportati dall'attività di copia come origini e destinazioni, vedere Archivi dati supportati.