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. ここでは、Product テーブルを含む Sales Marketing データセットをデータセットにプッシュします。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. データをプッシュするには、データセットの作成操作と行の追加操作を一緒に行います。To push data, you use the Create Dataset operation along with the Add Rows operation. データセットを検索するには、データセットの取得操作を行います。To find a dataset, you use the Get Datasets operation. これらの操作のどれについても、グループ ID を渡すとグループを操作できます。For any of these operations, you can pass a group id to work with a group. グループの取得操作を行うと、グループ ID の一覧を取得できます。Use the Get Groups operation to get a list of group id's.

データセットにデータをプッシュするための操作を次に示します。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 文字列を渡すことになります。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.

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

次の手順 >Next Step >

次の手順Next steps

Power BI にサインアップするSign up for Power BI
データセットの作成Create Dataset
データセットの取得Get Datasets
行の追加Add Rows
グループの取得Get Groups
JSON の紹介Introducing JSON
Power BI REST API の概要Overview of Power BI REST API
他にわからないことがある場合は、More questions? Power BI コミュニティを利用してくださいTry the Power BI Community