Ir al contenido

Mコード(Power Query)の高度な内容

OData V4 APIの信頼性のある使用を目的とした、M言語での決定論的抽出スクリプトとパターン。

0閲覧数

Power BIのセマンティックモデルへのネイティブAPIからのデータ抽出を管理するため、グラフィカルインターフェースに依存せず、高度なエディタでPower Queryのコード(M言語)を直接記述します。

これは、下位のHTTPリクエストのパラメータをすべて管理できる決定論的で制御可能な開発に近づけます。

1. オーダーパターンの基本的なOData抽出

Sección titulada «1. El Patrón Base de Extracción OData»

私たちのインジェストのコアはOData.Feed関数を使用しています。自動生成に依存する代わりに、私たちのビジネスコアからのすべての抽出に対してこのスニペットベースを標準化します:

let
// 1. Definición de la URL absoluta apuntando a nuestro Endpoint AL (EntitySetName)
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
// 2. Invocación de la API con inyección de protecciones de red
Origen = OData.Feed(UrlBase, null, [
Implementation="2.0",
Timeout=#duration(0, 0, 10, 0)
])
in
Origen

クリティカルパラメータの説明(DevSecOps)

Sección titulada «Explicación de los Parámetros Críticos (DevSecOps)»
  • Implementation="2.0": Power QueryにODataエンジンの最新バージョンを使用させます。JSONのバイナリレベルでの読み込みとメタデータの解析を最適化します。
  • Timeout=#duration(Days, Hours, Minutes, Seconds): システムのフリーズに対するセーフティ。私たちのAL APIは約30秒で最適化されていますが、10分(0, 0, 10, 0)の厳格な制限を注入します。MicrosoftのERPが深刻な劣化を経験した場合、Power BIはメモリに無期限にプロセスを保持することなくロードを中止します。

これらは、ビジネスインテリジェンスモデルにデータを供給するためにメインデータセットに統合された正確なスクリプトです。

2.1. 製品移動(ロジスティクスの事実)

Sección titulada «2.1. Movimientos de Producto (Hechos Logísticos)»
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/movimientos",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasCompra",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen
let
UrlBase = "https://api.businesscentral.dynamics.com/v2.0/a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d/Sandbox-Dev/api/portelcore/api_portelcore_1/v1.0/companies('PORTELCORE%20S.L.U')/lineasVenta",
Origen = OData.Feed(UrlBase, null, [Implementation="2.0", ODataVersion=4, Timeout=#duration(0, 0, 10, 0)])
in
Origen

3. ロード後の変換に関する考慮事項

Sección titulada «3. Consideraciones de Transformación Post-Carga»

私たちのアーキテクチャが< strong >プッシュダウンコンピューティング(ELT)に依存しているため、Mスクリプトの基本的なルールはローカルでの計算負荷をゼロに保つことです。

  1. フィルタなし (WHERE) で M: たとえば特定の倉庫や日付を除外するなどの行の除外処理は、すでにBusiness CentralのSQLエンジンで DataItemTableFilter プロパティを介して実行されています。
  2. Mでのカラム削除なし: HTTP経由で送信されるのは、エンドポイントで厳密にプロジェクションされたカラムのみです。Power Queryで90カラムを削除するために100カラムを取得する必要はありません。
  3. ローカルで行うのは 最終的なデータ型の変換 (Type Casting) だけです。 Table.TransformColumnTypes を使用して、DAXモデルに変更不可能なデータ (例: Int64.Type, type date, type number) を確実に受け渡します。
  • ✓ M実装: データ読み込みを高速化するため、すべてのクエリでパラメータ Implementation="2.0" を明示的に使用しています。
  • ✓ レイテンシ制御: Power BI Serviceの更新キューの安定性を保護するために、10分間の Timeout を事前にインジェクトしています。
  • ✓ ELT最適化: Power Queryでローカルフィルタを一切適用せず、すべてのデータロジックをSQLのバックエンドに保持しています。