データ アクセスの処理

データ ソース関数

データ コネクタは、M ライブラリ内のデータ ソース関数の動作をラップし、カスタマイズします。 たとえば、REST API の拡張機能では、HTTP 要求を行うために、Web.Contents 関数が使用されます。 現時点では、拡張機能をサポートできるデータソース関数の数は限られています。

• Web.Contents
• OData.Feed
• Odbc.DataSource
• AdoDotNet.DataSource
• OleDb.DataSource

例:

[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;

データソースの種類

拡張機能でsharedマークされた関数は、データ ソース定義レコードの名前を持つ関数にDataSource.Kindリテラル属性を含めることで、特定のデータ ソースに関連付けることができます。 データ ソース レコードでは、データ ソースでサポートされる認証の種類と、基本的なブランド化情報 (表示名/ラベルなど) を定義します。 レコードの名前が一意の識別子になります。

同じデータ ソースに関連付けられた各関数には、名前、タイプ、順序などの同じ必須関数パラメーターが必要です。 (データ ソースの種類の目的では、パラメーターがマークoptionalされている場合、またはそのメタデータに含まれているDataSource.Path = false場合は必須とは見なされません)。

特定のデータ ソースの種類の関数には、その種類に関連付けられた資格情報のみを使用できます。 資格情報は、関数の必須パラメーターの組み合わせに基づく参照を実行することで、実行時に識別されます。 資格情報を識別する方法について詳しくは、「データ ソース パス」を参照してください。

例:

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

プロパティ

次の表は、データ ソース定義レコードのフィールドの一覧です。

UI への発行

データ ソース 定義レコードと同様に、発行レコードは、Power Query UIに [データの取得] ダイアログでこの拡張機能を公開するために必要な情報を提供します。

例:

HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];

HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

プロパティ

次の表は、Publish レコードのフィールドの一覧です。