Microsoft Fabric の OneLake shortcuts は、データを OneLake にコピーして集約するのではなく、既存のデータソースを OneLake 上のフォルダーやテーブルのように参照できる仕組みです。結論から言えば、確認すべきポイントは「ショートカットを作れるか」ではなく、権限、SQL analytics endpoint のアクセスモード、キャッシュ、命名規則、削除操作、移行時の検証手順を本番前に決めておくことです。
特に 2026 年 5 月 6 日更新の Microsoft Learn では、OneLake security と SQL analytics endpoint の User identity mode / Delegated identity mode、ショートカット境界での権限評価、セキュリティ同期、所有権変更時の注意点が整理されています。OneLake shortcuts を導入する場合は、単なるデータ参照機能として扱わず、データガバナンスと運用設計を含めて展開する必要があります。(Microsoft Learn)
Microsoft Fabric の OneLake shortcuts は何を変えるのか
OneLake shortcuts は、OneLake 内外の保存場所を指すオブジェクトです。見た目は OneLake 上のフォルダーですが、実体データは Azure Data Lake Storage、Amazon S3、Google Cloud Storage、Dataverse、OneDrive、SharePoint、別ワークスペースの Lakehouse など、別の場所に存在できます。Microsoft Learn では、OneLake を企業全体の単一の仮想データレイクとして使い、クラウド、ドメイン、アカウントをまたいだデータ統合を実現する機能として説明されています。(Microsoft Learn)
従来は、分析のためにデータを Lakehouse や Warehouse にコピーし、パイプラインで同期し、コピー先ごとに権限や更新管理を行う必要がありました。OneLake shortcuts を使うと、既存データを参照したまま Fabric の Spark、SQL analytics endpoint、Real-Time Intelligence、Analysis Services、Power BI などから利用できます。つまり、データ統合の中心が「コピーして集める」から「参照して統制する」へ移ります。(Microsoft Learn)
ただし、ショートカットは万能な移行手段ではありません。ターゲットパスを移動、名前変更、削除するとショートカットが壊れる可能性があります。また、ショートカット自体を削除してもターゲットデータは残りますが、ショートカット配下のファイルやフォルダーを削除し、ターゲット側に削除権限がある場合は、元データまで削除される可能性があります。(Microsoft Learn)
影響を受ける対象者と確認すべき範囲
OneLake shortcuts の影響は、データエンジニアだけにとどまりません。Fabric 管理者、BI 開発者、セキュリティ担当、ネットワーク担当がそれぞれ確認すべきポイントを持っています。
| 対象者 | 主な確認ポイント | 実務上の注意点 |
|---|---|---|
| Fabric 管理者 | ワークスペース権限、OneLake security、SQL analytics endpoint のアクセスモード、キャッシュ設定 | User identity mode と Delegated identity mode の選択で、権限評価の場所が変わる |
| データエンジニア | Lakehouse の Tables / Files 配置、Delta 形式、ショートカット変換、REST API 展開 | Tables 配下は構造と命名制約が厳しいため、事前に設計する |
| BI 開発者 | Power BI セマンティックモデル、Direct Lake、SQL analytics endpoint 経由の参照 | DirectLake over SQL や T-SQL の Delegated identity mode では、エンドユーザーの ID がターゲットに渡らないケースがある |
| セキュリティ担当 | ショートカット元とターゲットの権限、OneLake security ロール、RLS / CLS | ショートカット境界をまたぐ場合、両側の権限が必要になる |
| ネットワーク・クラウド担当 | ADLS、S3、GCS、オンプレミスゲートウェイ、VPC / firewall 配下の接続 | OPDG を使う場合は、ゲートウェイ端末からストレージへ接続できるかを先に検証する |
作成や利用に必要な権限は、ショートカットを置く場所とターゲットパスの両方で評価されます。Microsoft Learn では、ショートカット作成には作成先 Fabric アイテムへの Write 権限と、ターゲットデータへの Read 権限が必要とされています。また、アクセス時はショートカットパスとターゲットパスの権限のうち、より制限の強い権限が適用されます。(Microsoft Learn)
2026 年時点で押さえるべき主な変更点
SQL analytics endpoint ではアクセスモードの選択が重要になる
2026 年 5 月 6 日更新の公式情報で特に重要なのは、SQL analytics endpoint から OneLake データやショートカットを扱う場合のアクセスモードです。
User identity mode では、SQL analytics endpoint がサインイン中のユーザー ID を OneLake に渡し、OneLake security のロールやポリシーでテーブルアクセスを制御します。一方、Delegated identity mode では、SQL analytics endpoint がワークスペースまたはアイテム所有者の ID で OneLake に接続し、SQL 側の GRANT / REVOKE、RLS、CLS、Dynamic Data Masking などで制御します。(Microsoft Learn)
実務では、次のように判断すると分かりやすくなります。
| 判断軸 | User identity mode が向くケース | Delegated identity mode が向くケース |
|---|---|---|
| ガバナンス方針 | OneLake で一元的に権限を管理したい | 既存の SQL 権限設計を重視したい |
| 利用者 | Power BI、Notebook、Lakehouse、SQL で一貫したアクセス制御をしたい | DBA やアプリケーションが SQL 権限を前提にしている |
| ショートカット利用 | ソース側の OneLake security を尊重したい | ソースに RLS / CLS がないテーブルを SQL 中心で扱う |
| 注意点 | OneLake ロール設定と同期を確認する | アイテム所有者の OneLake 権限不足でクエリが失敗する可能性がある |
特にショートカットを含む環境では、User identity mode の場合、ショートカット元とデータが物理的に存在する宛先の両方に有効なアクセス権が必要です。Delegated identity mode では、ソーステーブルに OneLake security の RLS や CLS が設定されている場合、SQL analytics endpoint からそのショートカットにアクセスできないケースがあります。(Microsoft Learn)
アクセスモード変更は業務時間外に行う
SQL analytics endpoint の OneLake アクセスモードを変更すると、同じワークスペース内の SQL analytics endpoint が一時的に利用できなくなり、実行中またはキュー中のクエリがキャンセルされます。さらに、User identity mode と Delegated identity mode の切り替えでは、TVF やスカラー関数などのインラインメタデータオブジェクトが削除される点も明記されています。(Microsoft Learn)
本番環境では、アクセスモードの切り替えを「設定変更」ではなく「メンテナンス作業」として扱うべきです。変更前に、影響を受ける SQL analytics endpoint、Power BI レポート、スケジュール実行、アプリケーション接続を洗い出し、クエリ停止を許容できる時間帯で実施します。
Shortcut transformations により、構造化ファイルを Delta テーブル化しやすくなった
OneLake shortcuts は参照機能ですが、Shortcut transformations を使うと、CSV、Parquet、JSON、Excel などの構造化ファイルを Delta Lake 形式のテーブルに変換できます。公式の What’s New では、2026 年 4 月に Shortcut transformations が Generally Available として掲載され、ファイルを OneLake に持ち込む、または移動する際に構造化ファイルを Delta テーブルへ自動変換できる機能として説明されています。(Microsoft Learn)
この機能は、外部ストレージ上の CSV や JSON をそのまま分析したいが、毎回 Data Pipeline や Notebook を作りたくない場合に有効です。Fabric はショートカットターゲットを一定間隔で確認し、新規・変更・削除されたファイルを Delta テーブルへ反映します。Microsoft Learn では、ポーリング間隔は 2 分、CSV / Parquet / JSON は GA、Excel 変換はプレビューと説明されています。(Microsoft Learn)
ただし、ファイルスキーマがそろっていないデータ、複雑な JSON、先頭ゼロを保持したい Excel、数式の再計算結果に依存する Excel では注意が必要です。Excel では、郵便番号や社員番号のような先頭ゼロ付き識別子が整数として推論され、先頭ゼロが失われる可能性があります。(Microsoft Learn)
キャッシュとクエリ高速化はコストと整合性を見て使う
外部ショートカットのキャッシュは、クロスクラウドアクセス時のエグレスコスト削減に役立ちます。OneLake は外部ショートカット経由で読み取ったファイルを Fabric ワークスペースのキャッシュに保存し、以後の読み取りではリモートストレージではなくキャッシュから応答できます。キャッシュ保持期間は 1 日から 28 日で設定でき、1 GB を超える個別ファイルはキャッシュされません。(Microsoft Learn)
一方、Real-Time Intelligence の Eventhouse で OneLake shortcuts を高速にクエリしたい場合は、Query acceleration も検討対象です。Query acceleration は外部 Delta テーブル上にキャッシュ期間を定義し、Eventhouse に直接取り込んだデータに近いパフォーマンスを狙う機能です。ただし、Accelerated data は OneLake Premium cache meter で課金され、インデックス作成や取り込み処理も CU 消費に影響する可能性があります。(Microsoft Learn)
本番展開では、すべてのショートカットでキャッシュや高速化を有効にするのではなく、次の条件に当てはまるものから優先します。
| 有効化を検討するケース | 理由 |
|---|---|
| AWS S3 や GCS など、クロスクラウドで頻繁に同じファイルを読む | エグレスコストと読み取り遅延を抑えやすい |
| KQL で外部 Delta テーブルを頻繁に参照する | Query acceleration により Eventhouse クエリ性能を改善できる可能性がある |
| 履歴データとリアルタイムストリームを組み合わせる | Eventhouse 側で分析しやすくなる |
| データ更新頻度が低く、参照頻度が高い | キャッシュの効果が出やすい |
逆に、更新直後の完全な即時反映が必要な検証や、巨大ファイルが中心のデータでは、キャッシュの効果や整合性確認の手順を慎重に設計する必要があります。
Lakehouse での配置ルールを理解する
OneLake shortcuts を Lakehouse に作る場合、Tables フォルダーと Files フォルダーの違いを理解しておく必要があります。Tables フォルダーは構造化データセット向けで、ショートカットは最上位レベルにのみ作成できます。サブディレクトリ内のショートカットはサポートされません。ターゲットが Delta Parquet 形式であれば、Lakehouse はメタデータを自動同期し、フォルダーをテーブルとして認識します。(Microsoft Learn)
Files フォルダーでは、フォルダー階層の任意のレベルにショートカットを作成できます。ただし、Files フォルダーではテーブル検出は行われません。分析テーブルとして扱いたい場合は、Tables 配下に置くか、Shortcut transformations で Delta テーブル化するかを検討します。(Microsoft Learn)
| 配置先 | 向いている用途 | 注意点 |
|---|---|---|
| Tables | Delta テーブルとして Spark、SQL、Power BI から扱いたいデータ | 最上位レベルのみ。Delta 形式や命名規則に注意 |
| Files | CSV、画像、ログ、半構造化データ、任意形式のファイル参照 | テーブルとしては自動認識されない |
| KQL database の Shortcuts フォルダー | Real-Time Intelligence で外部テーブルとしてクエリしたいデータ | KQL の external_table() で参照する |
日本語圏の環境で特に注意したいのが命名規則です。OneLake shortcut の名前、親パス、ターゲットパスには % や + を含められず、非ラテン文字もサポートされません。部署名や業務名を日本語で付けたくなりますが、ショートカット名やパスは英数字、アンダースコア、ハイフンを中心に統一したほうが安全です。(Microsoft Learn)
管理者が本番前に確認すべき設定
ショートカット元とターゲットの権限を分けて確認する
ショートカットは「置かれている場所」と「参照先」の両方で権限が評価されます。Lakehouse に対して書き込み権限があっても、ターゲット側が読み取りのみであれば書き込みはできません。逆に、ターゲット側に書き込み権限があっても、ショートカットパス側が読み取りのみであれば書き込みはできません。(Microsoft Learn)
確認時は、ユーザー単位ではなくグループ単位で以下を整理します。
| 確認項目 | 推奨される確認方法 |
|---|---|
| ショートカットを作成できるユーザー | 作成先 Fabric アイテムへの Write 権限を確認する |
| データを読めるユーザー | ショートカットパスとターゲットパスの両方に Read 権限があるか確認する |
| データを書き込めるユーザー | 両方に Write 権限が必要か、運用上書き込みを禁止すべきか確認する |
| Power BI から参照するユーザー | Direct Lake、SQL analytics endpoint、セマンティックモデルの ID 評価を確認する |
| 外部ショートカット | 外部システム側の資格情報、接続、ローテーション運用を確認する |
Power BI セマンティックモデルで DirectLake over SQL または T-SQL エンジンを Delegated identity mode で使う場合、呼び出し元ユーザーの ID がショートカットターゲットに渡されず、呼び出し元アイテム所有者の ID が使われます。この制限を避けたい場合は、DirectLake over OneLake mode または T-SQL の User identity mode を検討します。(Microsoft Learn)
クラウド接続は個人所有にしない
ADLS や S3 のショートカットでは、クラウド接続を使って承認を委任します。接続をショートカットに設定する操作はバインド操作であり、接続に対する権限を持つユーザーだけが実行できます。(Microsoft Learn)
実務でよくある失敗は、検証担当者の個人アカウントで作成した接続を本番ショートカットに使い、その担当者の異動や退職、資格情報変更でショートカットが壊れるケースです。Fabric では Lakehouse の設定からショートカット接続を確認でき、壊れた接続や複数ショートカットで共有されている接続をまとめて確認・置換できます。(Microsoft Learn)
本番では、接続の所有者、認証方式、資格情報の更新手順、障害時の置換担当を明文化しておきます。接続を置換すると、その古い接続を使っていたショートカットが新しい接続へ更新されるため、変更範囲の確認も重要です。(Microsoft Learn)
オンプレミスや閉域データは OPDG の疎通を先に検証する
オンプレミスまたはネットワーク制限されたデータソースには、Fabric on-premises data gateway を使ってショートカットを作成できます。公式情報では、Amazon S3、S3 compatible、Google Cloud Storage が対象タイプとして挙げられており、オンプレミスの S3 互換ストレージや firewall / VPC 配下のバケットにも対応できます。(Microsoft Learn)
展開前には、ゲートウェイをインストールした Windows マシンからストレージエンドポイントへ接続できるかを確認します。HTTPS で自己署名証明書を使っている場合は、ゲートウェイ端末側で証明書を信頼させる必要があります。認証情報には、一般にバケット一覧、オブジェクト一覧、データ読み取りができる権限が必要です。(Microsoft Learn)
開発者が確認すべき実装ポイント
Spark、SQL、KQL での読み方を事前に検証する
Tables 配下に Delta 形式のショートカットを作成した場合、Spark では相対パスまたは Spark SQL で読み取れます。SQL analytics endpoint では、Lakehouse の Tables セクションのショートカットをテーブルとして参照できます。KQL database ではショートカットが外部テーブルのように扱われ、external_table() でクエリします。(Microsoft Learn)
df = spark.read.format("delta").load("Tables/MyShortcut")
display(df)
df = spark.sql("SELECT * FROM MyLakehouse.MyShortcut LIMIT 1000")
display(df)SELECT TOP (100) *
FROM [MyLakehouse].[dbo].[MyShortcut];external_table('MyShortcut')
| take 100開発環境で動いたとしても、本番では SQL analytics endpoint のアクセスモード、OneLake security ロール、Power BI セマンティックモデルの所有者、ターゲット側の権限が変わることがあります。テストは管理者アカウントだけで行わず、実際の閲覧者、開発者、運用者の権限で実行することが重要です。
REST API で大量作成・棚卸しを自動化する
OneLake shortcuts は Fabric ポータルから作成できますが、REST API による自動化も可能です。公式の OneLake Shortcuts REST API には、Create Shortcut、Creates Shortcuts In Bulk、Delete Shortcut、Get Shortcut、List Shortcuts、Reset Shortcut Cache などの操作が用意されています。(Microsoft Learn)
複数ワークスペースや複数 Lakehouse に同じ命名規則でショートカットを展開する場合は、手作業より API を使ったほうが安全です。特に本番環境では、どのショートカットがどのターゲットを指しているかを一覧化し、接続、キャッシュ、権限、利用レポートを棚卸しできる状態にしておくと、障害対応や監査対応がしやすくなります。
コピー取り込みから OneLake shortcuts へ移行する判断基準
既存の ETL やデータコピーをすべて OneLake shortcuts に置き換える必要はありません。判断基準は「データを加工して保持したいのか」「既存データをそのまま参照したいのか」です。
| 選択肢 | 向いているケース | 避けたほうがよいケース |
|---|---|---|
| OneLake shortcuts | データ所有者を変えずに、複数ワークスペースや複数エンジンから参照したい | 参照先の変更が頻繁で、パス変更管理ができていない |
| Data Pipeline / Dataflow / Notebook でコピー | データクレンジング、標準化、履歴管理、品質チェックを行いたい | コピーの重複や同期遅延が大きな課題になっている |
| Shortcut transformations | CSV、JSON、Parquet、Excel を Delta テーブル化して SQL / Spark / Power BI で扱いたい | ファイルごとにスキーマが異なる、Excel の整形が複雑 |
| Query acceleration | Eventhouse で外部 Delta データを高頻度にクエリしたい | コスト管理やキャッシュ対象期間を決められない |
移行の第一候補は、複数部門が同じデータをコピーして使っている領域です。例えば、営業部門の S3 データ、経理部門の ADLS Gen2 データ、分析部門の Lakehouse データを、それぞれ別々にコピーして Power BI 用に加工している場合、OneLake shortcuts によって参照経路を整理できます。
一方で、データ品質チェック、PII マスキング、複雑な結合、履歴差分管理、監査ログ付与が必要なデータは、ショートカットだけで完結させず、ETL や Lakehouse の Silver / Gold レイヤーを併用したほうが安定します。
展開時に失敗しやすいポイント
日本語名のショートカットやパスを使ってしまう
日本語の部署名や業務名をそのままショートカット名に使うと、非ラテン文字の制約に引っかかる可能性があります。日本語圏では特に、営業データ、顧客分析、請求書一覧 のような名前を避け、sales-data、customer-analytics、invoice-list のように英数字中心で命名します。表示名や説明文で日本語を補うほうが運用しやすくなります。(Microsoft Learn)
ターゲット側の変更管理を忘れる
ショートカットは参照先の実体データから独立したオブジェクトですが、ターゲットパスが変わると壊れる可能性があります。ストレージ側でフォルダー名を変える、バケット構造を変更する、Lakehouse のテーブル名を変更する、といった操作は、ショートカット利用者への影響確認を含めて変更管理に入れるべきです。(Microsoft Learn)
ショートカット配下の削除を通常フォルダー削除と同じ扱いにする
ショートカット自体を削除してもターゲットデータは残ります。しかし、ショートカット配下のファイルやフォルダーを削除し、ターゲット側の削除権限がある場合は、ターゲットデータまで削除されます。運用画面ではフォルダーのように見えるため、誤削除防止の教育と権限設計が必要です。(Microsoft Learn)
SQL の所有権変更でセキュリティを崩す
2026 年 5 月 6 日更新の公式情報では、ショートカットバックのテーブルは SQL analytics endpoint 上で SQL オブジェクトとして表現されるため、ALTER AUTHORIZATION のような所有権変更が可能である一方、特定のシナリオでは OneLake security ポリシーを迂回する所有権チェーン動作につながる可能性があると説明されています。管理者は、追加の強制メカニズムが導入されるまでは、ショートカットバックのテーブルの所有権変更を避けるべきです。(Microsoft Learn)
セキュリティ同期のタイムラグを考慮しない
User identity mode では、OneLake security ロールの変更が SQL analytics endpoint に同期されます。公式情報では、通常は速いものの、同期には最大 5 分かかる場合があるとされています。また、Delegated identity mode では、所有者 ID のストレージアクセストークンがキャッシュされ、所有者権限の変更が即時に反映されないことがあります。(Microsoft Learn)
権限テストでは、設定直後の結果だけで判断せず、同期完了後に再テストします。特に本番リリース直前にロール変更や所有者変更を行うと、期待したアクセス制御になっているか確認しづらくなります。
本番展開前のチェックリスト
| チェック項目 | 確認内容 |
|---|---|
| データソース棚卸し | ADLS、S3、GCS、SharePoint、OneLake 内部参照など、対象ソースを一覧化したか |
| 命名規則 | ショートカット名、親パス、ターゲットパスを英数字中心に統一したか |
| 配置設計 | Tables に置くもの、Files に置くもの、KQL database で扱うものを分けたか |
| 権限設計 | ショートカットパスとターゲットパスの両方で Read / Write を確認したか |
| SQL アクセスモード | User identity mode と Delegated identity mode のどちらを使うか決めたか |
| Power BI 影響 | Direct Lake、セマンティックモデル所有者、閲覧者権限で検証したか |
| 接続管理 | 個人所有の接続ではなく、運用可能な接続と資格情報ローテーションを用意したか |
| キャッシュ | 保持期間、リセット手順、対象ショートカットを決めたか |
| 削除操作 | ショートカット削除とターゲットデータ削除の違いを運用者に周知したか |
| 監視 | ショートカット接続、変換ログ、SQL 同期、Fabric metrics app を確認する手順を決めたか |
まず何から始めるべきか
OneLake shortcuts の導入は、最初から全社データ統合を狙うより、影響範囲の小さい Lakehouse で検証するのが現実的です。まずは、読み取り専用で使う外部データを 1 つ選び、Tables と Files のどちらに置くべきかを判断します。そのうえで、管理者、開発者、閲覧者の 3 種類の権限で Spark、SQL analytics endpoint、Power BI からアクセスを確認します。
次に、SQL analytics endpoint を使う場合は User identity mode と Delegated identity mode のどちらを採用するかを決めます。OneLake security で一元管理したいなら User identity mode、既存の SQL 権限設計を維持したいなら Delegated identity mode が候補になります。ただし、ショートカット、RLS、CLS、所有者権限、セキュリティ同期の影響を必ず検証してください。
最後に、命名規則、接続管理、キャッシュ、削除操作、REST API 展開、監視手順をドキュメント化します。OneLake shortcuts はデータコピーを減らす便利な機能ですが、本番で価値を出すには「どこを指しているか」「誰が読めるか」「どのエンジンからどう評価されるか」を継続的に管理することが欠かせません。
コメント