Ü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.With the Power BI API, you can push data into a Power BI dataset. Angenommen, Sie möchten einen vorhandenen Geschäftsworkflow erweitern, um wichtige Daten per Push in ein Dataset zu übertragen.For example, you want to extend an existing business workflow to push key data into your dataset. In diesem Fall möchten Sie das Dataset „Sales Marketing“ mit einer Tabelle „Product“ per Push in ein Dataset übertragen.In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

Damit Sie Daten per Push an ein Dataset übermitteln können, benötigen Sie ein Azure Active Directory (Azure AD)- und ein Power BI-Konto.Before you get started pushing data into a dataset, 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 Anwendung einem Dataset Zeilen hinzufügt, werden die Kacheln auf dem Dashboard automatisch mit den neuen Daten aktualisiert.When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. Um Daten per Push zu übertragen, verwenden Sie die Vorgänge Dataset erstellen und Zeilen hinzufügen.To push data, you use the Create Dataset operation along with the Add Rows operation. Zum Auffinden eines Datasets verwenden Sie den Vorgang Datasets abrufen.To find a dataset, you use the Get Datasets operation. Für alle diese Vorgänge können Sie eine Gruppen-ID übergeben, um mit einer Gruppe zu arbeiten.For any of these operations, you can pass a group id to work with a group. Verwenden Sie den Vorgang Gruppen abrufen, um eine Liste mit Gruppen-IDs abzurufen.Use the Get Groups operation to get a list of group id's.

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"},
         { ... }
        ]
      }
    ]
}

Bei unserem Beispiel mit dem Dataset „Sales Marketing“ übergeben Sie eine JSON-Zeichenfolge wie im nachstehenden Beispiel.So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. In diesem Beispiel ist SalesMarketing der Name des Datasets und Product der Name der Tabelle.In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. Nach Definieren der Tabelle definieren Sie das Tabellenschema.After you define 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 (e.g. Min, Max).
BooleschBoolean KeineNone
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.33ms).
ZeichenfolgeString Derzeit sind bis zu 128.000 Zeichen zulässig.Currently allows up to 128K 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.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

Nächster Schritt >Next Step >

Nächste SchritteNext steps

Registrieren bei Power BISign up for Power BI
Create Dataset (Dataset erstellen)Create Dataset
Get Datasets (Datasets abrufen)Get Datasets
Add Rows (Zeilen hinzufügen)Add Rows
Get Groups (Gruppen abrufen)Get Groups
Einführung in JSONIntroducing JSON
Übersicht über Power BI-REST-APIOverview of Power BI REST API
Weitere Fragen?More questions? Wenden Sie sich an die Power BI-CommunityTry the Power BI Community