Power BI データセットにデータをプッシュするPush data into a Power BI dataset

Power BI API を使うと、Power BI データセットにデータをプッシュできます。The Power BI API lets you push data into a Power BI dataset. この記事では、Product テーブルを含んだ Sales Marketing データセットを、既存のデータセットにプッシュする方法について説明します。In this article, we show you how to push a Sales Marketing dataset containing a Product table into an existing dataset.

作業を開始する前に、Azure Active Directory (Azure AD) と Power BI アカウントが必要です。Before getting started, 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, dashboard tiles update automatically with the new data. データをプッシュするには、PostDataset および PostRows 操作を使います。To push data, use the PostDataset and PostRows operations. データセットを検索するには、データセットの取得操作を使います。To find a dataset, use the Get Datasets operation. これらの操作のいずれについても、グループ ID を渡してグループを操作することができます。You can pass a group ID to work with a group for any of these operations. グループ ID の一覧を取得するには、グループの取得操作を使います。To get a group ID list, use the Get Groups operation.

データセットにデータをプッシュするための操作を次に示します。Here are the operations to push data into a dataset:

Power BI でデータセットを作成するには、Power BI サービスに JavaScript Object Notation (JSON) 文字列を渡します。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 文字列を渡します。For our Sales Marketing dataset example, you would pass a JSON string as shown below. この例では、SalesMarketing がデータセット名、Product がテーブル名です。In this example, SalesMarketing is the dataset name, and Product is the table name. テーブルを定義したら、テーブル スキーマを定義します。After defining 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.

データセット オブジェクト JSON の例Example 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)。NaN not supported.+Infinity and -Infinity not supported in some functions (for example, Min, Max).
ブール値Boolean なしNone
DateTimeDatetime データの読み込み中に、日時分数の値を 1/300 秒 (3.33 ms) の整数倍に量子化します。During data loading, we quantize values with day fractions to whole multiples of 1/300 seconds (3.33 ms).
文字列String 現在、最大 128 K 文字が許可されています。Currently allows up to 128 K characters.

Power BI へのデータのプッシュに関する詳細Learn 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 nav pane.

次の手順Next steps

他にわからないことがある場合は、More questions? Power BI コミュニティを利用してくださいTry the Power BI Community