Eseguire il push dei dati in un set di dati di Power BIPush data into a Power BI dataset

Con l'API Power BI è possibile eseguire il push dei dati in un set di dati di Power BI.With the Power BI API, you can push data into a Power BI dataset. Si supponga ad esempio di voler estendere un flusso di lavoro aziendale esistente per eseguire il push dei dati chiave in un set di dati.For example, you want to extend an existing business workflow to push key data into your dataset. In questo caso, è possibile eseguire il push di un set di dati Sales Marketing che contiene una tabella Product in un set di dati.In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

Prima di iniziare il push dei dati in un set di dati, è necessario avere Azure Active Directory (Azure AD) e un account Power BI.Before you get started pushing data into a dataset, you need an Azure Active Directory (Azure AD) and a Power BI account.

Procedura per eseguire il push dei dati in un set di datiSteps to push data into a dataset

La sezione successiva fornisce una descrizione generale delle operazioni dell'API di Power BI che seguono il push dei dati.The next section is a general discussion of Power BI API operations that push data.

Operazioni dell'API di Power BI per eseguire il push dei datiPower BI API operations to push data

Con l'API REST di Power BI è possibile eseguire il push di origini dati in Power BI.With the Power BI REST API, you can push data sources to Power BI. Quando un'app aggiunge righe a un set di dati, i riquadri del dashboard vengono aggiornati automaticamente con i dati aggiornati.When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. Per eseguire il push dei dati, usare l'operazione Create Dataset con l'operazione Add Rows.To push data, you use the Create Dataset operation along with the Add Rows operation. Per trovare un set di dati, usare l'operazione Get Datasets.To find a dataset, you use the Get Datasets operation. Per ognuna di queste operazioni, è possibile passare un ID di gruppo per lavorare con un gruppo.For any of these operations, you can pass a group id to work with a group. Usare l'operazione Get Groups per ottenere un elenco di ID del gruppo.Use the Get Groups operation to get a list of group id's.

Ecco le operazioni per eseguire il push dei dati in un set di dati:Here are the operations to push data into a dataset:

Viene creato un set di dati in Power BI passando una stringa JSON (JavaScript Object Notation) al servizio Power BI.You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. Per altre informazioni su JSON, vedere l'introduzione a JSON.To learn more about JSON, see Introducing JSON.

La stringa JSON per un set di dati ha il formato seguente:The JSON string for a dataset has the following format:

Oggetto JSON del set di dati di Power BIPower BI Dataset JSON object

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

Pertanto, per il set di dati Sales Marketing di esempio, si passerà una stringa JSON come nell'esempio seguente.So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. In questo esempio, SalesMarketing è il nome del set e Product è il nome della tabella.In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. Dopo aver definito la tabella, si definisce lo schema di tabella.After you define the table, you define the table schema. Per il set di dati SalesMarketing , lo schema di tabella contiene le colonne ProductID, Manufacturer, Category, Segment, Product e IsCompete.For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

Esempio JSON per l'oggetto set di datiExample 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"
            }
            ]
        }
    ]
}

Per uno schema di tabella di Power BI, è possibile usare i tipi di dati seguenti.For a Power BI table schema, you can use the following data types.

Tipi di dati per una tabella di Power BIPower BI table data types

Tipo di datiData type RestrizioniRestrictions
Int64Int64 Int64.MaxValue e Int64.MinValue non sono consentiti.Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble Double.MaxValue e Double.MinValue non sono consentiti.Double.MaxValue and Double.MinValue values not allowed. NaN non supportato. +Infinity e -Infinity non supportati in alcune funzioni, ad esempio Min, Max.NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
BooleanoBoolean NessunoNone
DateTimeDatetime Durante il caricamento dei dati, i valori vengono quantizzati con frazioni giornaliere fino a multipli interi di 1/300 secondi (3,33 ms).During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
StringString Sono attualmente consentiti al massimo 128.000 caratteri.Currently allows up to 128K characters.

Altre informazioni sul push dei dati in Power BILearn more about pushing data into Power BI

Per le attività iniziali per il push dei dati in un set di dati, vedere Passaggio 1: Registrare un'app in Azure AD nel riquadro di spostamento a sinistra.To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

Passaggio successivo >Next Step >

Passaggi successiviNext steps

Iscriversi a Power BISign up for Power BI
Crea set di datiCreate Dataset
Recupera set di datiGet Datasets
Aggiungi righeAdd Rows
Recupera gruppiGet Groups
Introduzione a JSONIntroducing JSON
Panoramica dell'API REST di Power BIOverview of Power BI REST API
Altre domande?More questions? Provare la community di Power BITry the Power BI Community