將資料推送至 Power BI 資料集Push data into a Power BI dataset

您可以使用 Power BI API 將資料推送至 Power BI 資料集。With the Power BI API, you can push data into a Power BI dataset. 例如,您會想要擴充現有商務工作流程,將關鍵資料推送至資料集。For example, you want to extend an existing business workflow to push key data into your dataset. 在此情況下,您會想要將 Sales Marketing 資料集 (其中含 Product 資料表) 推送至資料集。In this case, you want to push a Sales Marketing dataset which has a Product table into a dataset.

開始將資料推送至資料集之前,您需要 Azure Active Directory (Azure AD) 和 Power BI 帳戶Before you get started pushing data into a dataset, you need an Azure Active Directory (Azure AD) and a Power BI account.

將資料推送至資料集的步驟Steps to push data into a dataset

下一節是有關資料推送的 Power BI API 作業的一般討論。The next section is a general discussion of Power BI API operations that push data.

推送資料的 Power BI API 作業Power BI API operations to push data

透過 Power BI REST API,您可以將資料來源推送至 Power BI。With the Power BI REST API, you can push data sources to Power BI. 當應用程式將資料列加入資料集時,儀表板上的磚會自動更新為更新的資料。When an app adds rows to a dataset, tiles on the dashboard are updated automatically with the updated data. 若要推送資料,您可使用 PostDataset 作業和 PostRows 作業。To push data, you use the PostDataset operation along with the PostRows operation. 若要找出資料集,您可以使用取得資料集作業。To find a dataset, you use the Get Datasets operation. 針對任何一項作業,您可以傳遞群組識別碼來和群組合作。For any of these operations, you can pass a group id to work with a group. 使用取得群組作業,以取得群組識別碼清單。Use the Get Groups operation to get a list of group id's.

以下是將資料推送至資料集的作業:Here are the operations to push data into a dataset:

您可以將 JavaScript 物件標記法 (JSON) 字串傳遞至 Power BI 服務,在 Power BI 中建立資料集。You create a dataset in Power BI by passing a JavaScript Object Notation (JSON) string to the Power BI service. 若要深入了解 JSON,請參閱 JSON 簡介To learn more about JSON, see Introducing JSON.

資料集的 JSON 字串具有下列格式:The JSON string for a dataset has the following format:

Power BI 資料集 JSON 物件Power BI Dataset JSON object

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

因此,對於我們的 Sales Marketing 資料集範例,您會傳遞 JSON 字串,如以下範例。So, for our Sales Marketing dataset example, you would pass a JSON string such as the example below. 在此範例中, SalesMarketing 是資料集的名稱,而 Product 是資料表的名稱。In this example, SalesMarketing is the name of the dataset, and Product is the name of the table. 定義資料表之後,您會定義資料表的結構描述。After you define the table, you define the table schema. 對於 SalesMarketing 資料集,資料表結構描述具有下列資料行:ProductID、Manufacturer、Category、Segment、Product 和 IsCompete。For the SalesMarketing dataset, the table schema has these columns: ProductID, Manufacturer, Category, Segment, Product, and IsCompete.

範例資料集物件 JSONExample 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"
            }
            ]
        }
    ]
}

在 Power BI 資料表結構描述中,您可以使用下列資料類型。For a Power BI table schema, you can use the following data types.

Power BI 資料表資料類型Power BI table data types

資料類型Data type 限制Restrictions
Int64Int64 不允許 Int64.MaxValue 和 Int64.MinValue。Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble 不允許 Double.MaxValue 和 Double.MinValue 值。Double.MaxValue and Double.MinValue values not allowed. 不支援 NaN。部分函式 (例如 Min、Max) 不支援 +Infinity 和 -Infinity。NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
BooleanBoolean None
DatetimeDatetime 在資料載入期間,會以一天時間分數將值量化為 1/300 秒 (3.33 毫秒) 的整數倍數。During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
字串String 目前允許最多 12 萬 8 千個字元。Currently allows up to 128K characters.

深入了解如何將資料推送至 Power BILearn more about pushing data into Power BI

若要開始將資料推送至資料集,請參閱左側瀏覽窗格中的步驟 1:使用 Azure AD 註冊應用程式To get started pushing data into a dataset, see Step 1: Register an app with Azure AD in the left navigation pane.

下一步 >Next Step >

後續步驟Next steps

註冊 Power BISign up for Power BI
JSON 簡介Introducing JSON
Power BI REST API 概觀Overview of Power BI REST API
有其他問題嗎?More questions? 試試 Power BI 社群Try the Power BI Community