Übertragen von Daten in ein Power BI-Dataset per PushPush data into a Power BI dataset

Mit der Power BI-API können Sie Daten per Push in ein Power BI-Dataset übertragen.The Power BI API lets you push data into a Power BI dataset. In diesem Artikel erfahren Sie, wie Sie ein Sales Marketing-Dataset, das eine Tabelle „Product“ enthält, per Push in ein vorhandenes Dataset übermitteln.In this article, we show you how to push a Sales Marketing dataset containing a Product table into an existing dataset.

Damit Sie beginnen können, benötigen Sie ein Azure Active Directory- (Azure AD) und ein Power BI-Konto.Before getting started, you need an Azure Active Directory (Azure AD) and a Power BI account.

Schritte zum Übertragen von Daten per Push in ein DatasetSteps to push data into a dataset

Im nächste Abschnitt folgt eine allgemeine Erläuterung von Power BI-API-Vorgängen, die Daten per Push übertragen.The next section is a general discussion of Power BI API operations that push data.

Power BI-API-Vorgänge zum Übertragen von Daten per PushPower BI API operations to push data

Mit der Power BI-REST-API können Sie Datenquellen per Push in Power BI übertragen.With the Power BI REST API, you can push data sources to Power BI. Wenn eine App Zeilen zu einem Dataset hinzufügt, werden Dashboardkacheln automatisch mit den neuen Daten aktualisiert.When an app adds rows to a dataset, dashboard tiles update automatically with the new data. Verwenden Sie zum Pushen von Daten die Vorgänge PostDataset und PostRows.To push data, use the PostDataset and PostRows operations. Zum Suchen von Datasets verwenden Sie den Vorgang Get Datasets.To find a dataset, use the Get Datasets operation. Sie können eine Gruppen-ID übergeben, wenn Sie für einen dieser Vorgänge mit einer Gruppe arbeiten möchten.You can pass a group ID to work with a group for any of these operations. Zum Abrufen einer Liste der Gruppen-IDs verwenden Sie den Vorgang Get Groups.To get a group ID list, use the Get Groups operation.

Es folgen die Vorgänge, um Daten per Push in ein Dataset zu übertragen:Here are the operations to push data into a dataset:

Erstellen Sie ein Dataset in Power BI durch Übergeben einer JSON-Zeichenfolge (JavaScript Object Notation) an den Power BI-Dienst.You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. Weitere Informationen zu JSON finden Sie unter Einführung in JSON.To learn more about JSON, see Introducing JSON.

Die JSON-Zeichenfolge für ein Dataset hat das folgende Format:The JSON string for a dataset has the following format:

JSON-Objekt mit dem Power BI-DatasetPower BI Dataset JSON object

{"name": "dataset_name", "tables":
    [{"name": "", "columns":
        [{ "name": "column_name1", "dataType": "data_type"},
         { "name": "column_name2", "dataType": "data_type"},
         { ... }
        ]
      }
    ]
}

Für unser Beispiel mit dem Sales Marketing-Dataset würden Sie eine JSON-Zeichenfolge übergeben, wie unten dargestellt.For our Sales Marketing dataset example, you would pass a JSON string as shown below. In diesem Beispiel ist SalesMarketing der Name des Datasets und Product der Name der Tabelle.In this example, SalesMarketing is the dataset name, and Product is the table name. Nach dem Definieren der Tabelle definieren Sie das Tabellenschema.After defining the table, you define the table schema. Das Tabellenschema des Datasets SalesMarketing weist die folgenden Spalten auf: ProductID, Manufacturer, Category, Segment, Product, IsCompete.For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

Beispiel-JSON für DatasetobjektExample dataset object JSON

{
    "name": "SalesMarketing",
    "tables": [
        {
            "name": "Product",
            "columns": [
            {
                "name": "ProductID",
                "dataType": "int"
            },
            {
                "name": "Manufacturer",
                "dataType": "string"
            },
            {
                "name": "Category",
                "dataType": "string"
            },
            {
                "name": "Segment",
                "dataType": "string"
            },
            {
                "name": "Product",
                "dataType": "string"
            },
            {
                "name": "IsCompete",
                "dataType": "bool"
            }
            ]
        }
    ]
}

Für ein Power BI-Tabellenschema können Sie die folgenden Datentypen verwenden.For a Power BI table schema, you can use the following data types.

Power BI-TabellendatentypenPower BI table data types

DatentypData type EinschränkungenRestrictions
Int64Int64 Int64.MaxValue und Int64.MinValue sind nicht zulässig.Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble Die Werte Double.MaxValue und Double.MinValue sind nicht zulässig.Double.MaxValue and Double.MinValue values not allowed. NaN wird nicht unterstützt. +Infinity und -Infinity werden bei einigen Funktionen (z. B. Min, Max) nicht unterstützt.NaN not supported.+Infinity and -Infinity not supported in some functions (for example, Min, Max).
Boolescher WertBoolean OhneNone
DatetimeDatetime Beim Laden von Daten werden Werte mit Bruchteilen von Tagen auf ganze Vielfache von 1/300 Sekunden (3,33 ms) quantisiert.During data loading, we quantize values with day fractions to whole multiples of 1/300 seconds (3.33 ms).
ZeichenfolgeString Derzeit sind bis zu 128.000 Zeichen zulässig.Currently allows up to 128 K characters.

Weitere Informationen zum Übertragen von Daten per Push in Power BILearn more about pushing data into Power BI

Informationen zum Einstieg in das Übertragen von Daten per Push in ein Dataset finden Sie links im Navigationsbereich unter Schritt 1: Registrieren einer App in Azure AD im Navigationsbereich.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the nav pane.

Nächste SchritteNext steps

Weitere Fragen?More questions? Wenden Sie sich an die Power BI-CommunityTry the Power BI Community