Transformieren von Daten in Smartsheet (Vorschau) mithilfe von Azure Data Factory oder Synapse Analytics

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel wird beschrieben, wie Sie mithilfe eines Datenflusses Daten in Smartsheet (Vorschau) transformieren. Um mehr zu lernen, lesen Sie den Einführungsartikel für Azure Data Factory oder Azure Synapse Analytics.

Wichtig

Dieser Connector befindet sich derzeit in der Vorschauversion. Sie können ihn ausprobieren und uns Feedback geben. Wenden Sie sich an den Azure-Support, wenn Sie in Ihrer Lösung eine Abhängigkeit von Connectors verwenden möchten, die sich in der Vorschauphase befinden.

Unterstützte Funktionen

Für den Smartsheet-Connector werden die folgenden Funktionen unterstützt:

Unterstützte Funktionen	IR
Zuordnungsdatenfluss (Quelle/–)	①

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Eine Liste der Datenspeicher, die als Quellen/Senken unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Erstellen eines mit Smartsheet verknüpften Diensts über die Benutzeroberfläche

Verwenden Sie die folgenden Schritte, um einen mit Smartsheet verknüpften Dienst auf der Azure-Portal-Benutzeroberfläche zu erstellen.

1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zur Registerkarte „Verwalten“, und wählen Sie „Verknüpfte Dienste“ und anschließend „Neu“ aus:

   Azure Data Factory

   

   Azure Synapse

   

2. Suchen Sie nach Smartsheet (Vorschau), und wählen Sie den entsprechenden Connector aus.

   

3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

   

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Informationen zu Eigenschaften, die zum Definieren von Data Factory- und Synapse-Pipelineentitäten speziell für Smartsheet verwendet werden.

Eigenschaften des verknüpften Diensts

Folgende Eigenschaften werden für den mit Smartsheet verknüpften Dienst unterstützt:

Eigenschaft	Beschreibung	Erforderlich
Typ	Die „type“-Eigenschaft muss auf Smartsheet festgelegt sein.	Ja
apiToken	Geben Sie ein API-Token für Smartsheet an. Markieren Sie dieses Feld als SecureString, um es sicher zu speichern. Alternativ können Sie auf ein in Azure Key Vault gespeichertes Geheimnis verweisen.	Ja

Beispiel:

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

Eigenschaften von Mapping Data Flow

Beim Transformieren von Daten im Zuordnungsdatenfluss können Sie Tabellen aus Smartsheet lesen. Weitere Informationen finden Sie im Artikel zur Quelltransformation im Zuordnungsdatenfluss. Sie können nur ein Inlinedataset als Quelltyp verwenden.

Quellentransformation

In der folgenden Tabelle sind die von einer Smartsheet-Quelle unterstützten Eigenschaften aufgeführt. Sie können diese Eigenschaften auf der Registerkarte Quelloptionen bearbeiten.

Name	BESCHREIBUNG	Erforderlich	Zulässige Werte	Datenflussskript-Eigenschaft
Entitätstyp	Der Typ des Datenobjekts in Smartsheet.	Ja, bei Verwendung des Inlinemodus	sheets reports	entityType
Name der Entität	Der Name eines Blatts oder Berichts in Smartsheet.	Ja, bei Verwendung des Inlinemodus	String	entityId

Beispiele für Smartsheet-Quellskripts

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

Zugehöriger Inhalt

Eine Liste der Datenspeicher, die als Quelles und Senken für die Kopieraktivität unterstützt werden, finden Sie in Unterstützte Datenspeicher.