Power BI データセットにデータをプッシュする

Power BI API を使うと、Power BI データセットにデータをプッシュできます。 この記事では、Product テーブルを含んだ Sales Marketing データセットを、既存のデータセットにプッシュする方法について説明します。

作業を開始する前に、Azure Active Directory (Azure AD) と Power BI アカウントが必要です。

データセットにデータをプッシュする手順

次のセクションでは、データをプッシュする Power BI API 操作の概要を説明します。

データをプッシュする Power BI API の操作

Power BI REST API を使うと、Power BI にデータ ソースをプッシュできます。 アプリによりデータセットに行が追加されると、ダッシュボードのタイルは新しいデータで自動的に更新されます。 データをプッシュするには、PostDataset および PostRows 操作を使います。 データセットを検索するには、データセットの取得操作を使います。 これらの操作のいずれについても、グループ ID を渡してグループを操作することができます。 グループ ID の一覧を取得するには、グループの取得操作を使います。

データセットにデータをプッシュするための操作を次に示します。

Power BI でデータセットを作成するには、Power BI サービスに JavaScript Object Notation (JSON) 文字列を渡します。 JSON について詳しくは、「JSON の紹介」をご覧ください。

データセットの JSON 文字列は、次のような形式です。

Power BI のデータセット JSON オブジェクト

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

Sales Marketing データセットの例では、以下のような JSON 文字列を渡します。 この例では、SalesMarketing がデータセット名、Product がテーブル名です。 テーブルを定義したら、テーブル スキーマを定義します。 SalesMarketing データセットの場合、テーブル スキーマには、ProductID、Manufacturer、Category、Segment、Product、IsCompete の列が含まれています。

データセット オブジェクト 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 のテーブル スキーマでは、次のデータ型を使うことができます。

Power BI テーブルのデータ型

データの種類 制限事項
Int64 Int64.MaxValue と Int64.MinValue が許可されまていせん。
Double Double.MaxValue と Double.MinValue 値が許可されていません。 NaN はサポートされていません。一部の関数では正の無限大と負の無限大がサポートされていません (例: Min、Max)。
Boolean なし
Datetime データの読み込み中に、日時分数の値を 1/300 秒 (3.33 ms) の整数倍に量子化します。
String 現在、最大 128 K 文字が許可されています。

Power BI へのデータのプッシュに関する詳細

データセットへのデータのプッシュを始める方法については、「手順 1:ナビ ペインで Azure AD にアプリを登録します。

次のステップ

その他の質問 Power BI コミュニティを利用してください