Azure Synapse Analytics の既知の問題
このページでは、Azure Synapse Analytics の既知の問題と、その解決日または考えられる回避策を一覧で紹介します。 Azure サポート リクエストを送信する前に、このリストを確認して、発生している問題が既知であり、対処されているかどうかを確認してください。
Azure Synapse Analytics の詳細については、「Azure Synapse Analytics の概要」と「Azure Synapse Analytics の新機能」を参照してください。
アクティブな既知のイシュー
Azure Synapse Analytics 専用 SQL プールに関するアクティブな既知の問題の概要
お客様はメトリックを使用して専用 SQL プールの使用状況を監視できません
テレメトリ データのパフォーマンスと信頼性の強化を意図した、テレメトリの送信ロジックの内部アップグレードによって予想外の問題が発生し、専用 SQL プール、tempdb、データ ウェアハウス データ IO メトリックを監視するお客様側の機能に影響が出ました。
回避策: 問題を特定したら、根本原因を特定し、システムの構成を更新する措置をチームが取りました。 お客様はインスタンスを一時停止し、再開することでこの問題を解消できます。その作業により、インスタンスとテレメトリ データ フローが通常の状態に戻ります。
AUTO_CREATE_TABLE='ON' を使ってテーブルに Parquet ファイルを取り込むと、クエリが失敗する
お客様が AUTO_CREATE_TABLE='ON' を使用して Parquet ファイルをハッシュ分散テーブルに取り込もうとすると、次のエラーを受け取る場合があります。
COPY statement using Parquet and auto create table enabled currently cannot load into hash-distributed tables
AUTO_CREATE_TABLE を使って自動作成されたハッシュ分散テーブルへのインジェストはサポートされていません。 このサポートされていないシナリオを使って以前に読み込んだことがあるお客様は、新しいテーブルにデータの CTAS を行い、古いテーブルではなくそれを使うことをお勧めします。
データ流出エラーで失敗するクエリ
Synapse Analytics でデータ流出の防止がオフになっている場合、既存の専用 SQL プールから作成された Synapse ワークスペースで、一般的なエラー メッセージのデータ流出の防止に関連するクエリ エラーが報告されます。
Data exfiltration to '{****}' is blocked. Add destination to allowed list for data exfiltration and try again.
回避策: 同様のエラーが発生した場合は、Microsoft サポート チームにお問い合わせください。
UPDATE STATISTICS のエラー
一部の専用 SQL プールでは、UPDATE STATISTICS ステートメントの実行時に例外が発生する可能性があります。 このコマンドの結果、「指定された統計ストリームが破損しています」というメッセージが表示され、統計情報の更新に失敗します。
テーブルに新しい制約が追加されると、分布に関連する統計が作成されます。 クラスター化インデックスもテーブルに作成される場合は、制約と同じ列を (同じ順序で) 含める必要があります。そうしないと、それらの列に対する UPDATE STATISTICS コマンドが失敗する可能性があります。
回避策: テーブルに制約とクラスター化インデックスが存在するかどうかを特定します。 その場合は、制約とクラスター化インデックスの両方を DROP します。 その後、クラスター化インデックスと制約を再作成します。その際、両方に同じ順序で同じ列を含めるようにしてください。テーブルに制約とクラスター化インデックスがない場合、または上記の手順で同じエラーが発生する場合は、Microsoft サポート チームにお問い合わせください。
タグの更新が失敗しているように見える
Azure portal やその他のメソッドを使用して専用 SQL プールのタグを変更すると、変更が正常に行われた場合でもエラー メッセージが表示される場合があります。
回避策: タグの変更が成功したことを確認し、必要に応じてエラー メッセージを無視または抑制できます。
Azure Synapse ワークスペースに関するアクティブな既知の問題の概要
Synapse ワークスペースに関する既知の問題を次に示します。
ユーザー割り当てマネージド ID (UAMI) を使った BLOB ストレージ リンク サービスが一覧に表示されない
Azure Synapse Analytics で "ユーザー割り当てマネージド ID" 認証を使うように BLOB ストレージ リンク サービスを構成した後に、[データ ハブ] ->[リンク済み] ->[Azure Blob Storage] の下にリンク サービスが表示されない可能性があります。
回避策: 現在、エンジニアリング チームはこの動作を認識しており、修正プログラムに取り組んでいます。 代替策として、"ユーザー割り当てマネージド ID" ではなく "システム割り当てマネージド ID" の認証方法を使ってください。
Synapse ワークスペースの削除に失敗し、仮想ネットワークを削除できない
Synapse ワークスペースの削除が次のエラー メッセージで失敗します。
Failed to delete Synapse workspace '[Workspace Name]'. Unable to delete virtual network. The correlationId is ********-****-****-****-************;
回避策: この問題は、削除操作を再試行することで軽減できます。 エンジニアリング チームはこの動作を認識しており、修正プログラムに取り組んでいます。
ネットワーク設定を更新するための REST API PUT 操作や ARM/Bicep テンプレートが失敗する
公衆ネットワークのアクセス設定や Synapse ワークスペースのファイアウォール規則を変更するために ARM/Bicep テンプレートを使うか直接 REST API PUT 操作を行う場合、操作が失敗することがあります。
回避策: この問題は、REST API PATCH 操作や Azure portal UI を使って目的の構成変更を元に戻して再試行することで軽減できます。 エンジニアリング チームはこの動作を認識しており、修正プログラムに取り組んでいます。
タグの値に角かっこ [] が組み込まれた場合の既知の問題
Azure Synapse ワークスペース内のタグ値を更新するコンテキストでは、角かっこ ([]) を含めると更新操作が失敗します。
回避策: 現在の回避策は、Azure Synapse ワークスペースのタグ値で角かっこ ([]) を使わないことです。
ARM テンプレートを使って GitHub アクションでの Synapse-workspace-deployment v1.8.0 を使用した Synapse ワークスペースでのデプロイ エラー
このエラーは、運用環境へのデプロイ中に発生し、二重円記号を持つホスト名を含むトリガーに関連します。
表示されるエラー メッセージは "Action failed - Error: Orchestrate failed - SyntaxError: Unexpected token in JSON at position 2057" です。
回避策: 迅速な軽減策として次のアクションを実行できます:
- エスケープ文字を削除する: デプロイ前に、パラメーター ファイルからエスケープ文字 (
\) を手動で削除します。 つまり、ファイルを編集して、デプロイの解析または処理段階の最中に問題を引き起こす可能性のあるこれらの文字を排除します。 - エスケープ文字をスラッシュに置き換える: エスケープ文字 (
\) をスラッシュ (/) に置き換えます。 これは、多くのシステムが有効なパス区切りとしてスラッシュを受け入れるファイル パスで特に便利です。 この置換は、エスケープ文字の問題を回避し、デプロイ プロセスを成功させるのに役立つ場合があります。
これらの回避策のいずれかを適用し、正常にデプロイしたら、ワークスペース内の必要な構成を手動で更新して、すべてが正しく設定されていることを確認します。 これには、構成ファイルの編集、設定の調整、またはデプロイされている特定の環境またはアプリケーションに関連するその他のタスクの実行が含まれる場合があります。
"Microsoft.Synapse/workspaces/trustedServiceBypassEnabled" 設定に専用の 'GET' API 操作がない
問題の概要: Azure Synapse Analytics に、リソース スコープ "Microsoft.Synapse/workspaces/trustedServiceBypassEnabled" で "trustedServiceBypassEnabled" 設定の状態を取得するための専用の 'GET' API 操作がありません。 ユーザーはこの構成を設定できますが、この特定のリソース スコープを介してその状態を直接取得できません。
影響: この制限により、Azure Policy の定義に、"trustedServiceBypassEnabled" 設定に特定の状態を適用できないという影響があります。 お客様は、Azure Policy を使ってこの構成を拒否または管理できません。
回避策: Azure Policy には、このプロパティに望ましい構成状態を適用するために利用できる回避策はありません。 ただし、ユーザーは 'GET' ワークスペース操作を使って、レポートのために構成状態を監査できます。
この 'GET' ワークスペース操作は、Azure Policy の 'Microsoft.Synapse/workspaces/trustedServiceBypassEnabled' エイリアスにマップします。
Azure Policy エイリアスは、操作が Microsoft.Synapse/workspace リソースに対する PUT 要求である場合は、拒否 Azure Policy 効果でこのプロパティを管理するために使用できますが、PUT 要求が Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration 子リソースに直接送信されている場合は、監査目的でのみ機能します。 親リソースには、子リソースからの構成をマップするプロパティ [properties.trustedServiceBypassEnabled] があり、これがこのような場合でも親リソースの Azure Policy エイリアスを通じて監査できる理由です。
Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration 子リソースには利用できる GET 操作がないため、Azure Policy はこれらの要求を管理できず、Azure Policy はそれに対する Azure Policy エイリアスを生成できません。
親リソース: Microsoft.Synapse/workspaces
子リソース: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration
Azure portal は、子リソースの PUT API に直接 PUT 要求を行うため、親 Microsoft.Synapse/workspaces API の外部で行われた他の API 要求と同様に、拒否または他のアクション可能な Azure Policy 効果を使って Azure Policy で管理することはできません。
Azure Synapse Analytics サーバーレス SQL プールに関するアクティブな既知の問題の概要
サーバーレス SQL プールから Azure Cosmos DB 分析ストアへのクエリ エラー
サーバーレス SQL プールから Azure Cosmos DB 分析ストアへのクエリは、次のいずれかのエラー メッセージで失敗する場合があります。
Resolving CosmosDB path has failed with error 'This request is not authorized to perform this operation'Resolving CosmosDB path has failed with error 'Key not found'
この問題を確認するには、次の条件を満たしている必要があります。
- Azure Cosmos DB 分析ストアへの接続には、プライベート エンドポイントを使います。
- クエリを再試行すると成功します。
回避策: エンジニアリング チームはこの動作を認識しています。また、簡単な軽減策として次のアクションを実行できます。
- 失敗したクエリを再試行します。 これで、期限切れのトークンが自動的に更新されます。
- プライベート エンドポイントを無効にします。 この変更を適用する前に、会社のセキュリティ ポリシーを満たしていることをセキュリティ チームに確認してください。
Azure Cosmos DB 分析ストア ビューで、列に誤った属性が反映される
Cosmos DB 分析ストアを介して Azure Synapse サーバーレス プールでビューを使用しているときに、Cosmos DB 分析ストア内のファイルが変更されると、その変更は SELECT ステートメントに正しく反映されず、お客様はビューでそれを使用することになります。 その結果、属性が結果の異なる列に誤ってマップされます。
回避策: エンジニアリング チームはこの動作を認識しています。また、簡単な軽減策として次のアクションを実行できます。
- 列の名前を変更して、ビューを再作成します。
- 可能な場合は、ビューの使用を避けてください。
資格情報が使用されている場合、データベーススコープの資格情報の変更が失敗する
ALTER DATABASE SCOPED CREDENTIAL クエリを実行できない場合があります。 この問題の根本原因は、資格情報が最初に使用された後にキャッシュされ、変更のためにアクセスできないことです。 返されるエラーは次のとおりです。
Failed to modify the identity field of the credential '{credential_name}' because the credential is used by an active database file.
回避策: 現在、エンジニアリング チームはこの動作を認識しており、修正プログラムに取り組んでいます。 回避策として、資格情報を DROP および CREATE できます。これは、資格情報を使用して外部テーブルを再作成することを意味します。 または、Microsoft サポート チームに支援を求めることもできます。
サーバーレス SQL プールでのクエリ エラー
トークンの有効期限が切れた場合、ストレージに対してユーザーに必要なアクセス許可があるにもかかわらず、クエリの実行中にエラーが発生する可能性があります。 これらのエラー メッセージは、ロールベースのアクセス制御 (RBAC) ロールがストレージ アカウントに割り当てられない場合など、一般的なユーザー エラーが原因で発生する可能性もあります。
エラー メッセージの例:
WaitIOCompletion call failed. HRESULT = 0x80070005'. File/External table name: {path}Unable to resolve path '%' Error number 13807, Level 16, State 1, Message "Content of directory on path '%' cannot be listed.Error 16561: External table '<table_name>' is not accessible because content of directory cannot be listed.Error 13822: File {path} cannot be opened because it does not exist or it is used by another process.Error 16536: Cannot bulk load because the file "%ls" could not be opened.
対処法:
解決は、認証、Microsoft Entra (旧称 Azure Active Directory) またはマネージド サービス ID (MSI) によって異なります:
Microsoft Entra トークンの有効期限の場合:
実行時間の長いクエリの場合は、ユーザー ID を使用する代わりに、サービス プリンシパル、マネージド ID、または Shared Access Signature (SAS) に切り替えます。 詳細については、「Azure Synapse Analytics でサーバーレス SQL プールのストレージ アカウント アクセスを制御する」を参照してください。
クライアント (SSMS/ADS) を再起動して新しいトークンを取得し、接続を確立します。
MSI トークンの有効期限の場合:
- 次に、トークン キャッシュをクリアするためにプールを非アクティブ化してアクティブ化します。 Microsoft サポート チームにお問い合わせください。
Authorization ヘッダーが長すぎるためのストレージ アクセスの問題
サーバーレス SQL プールでのエラー メッセージの例:
File {path} cannot be opened because it does not exist or it is used by another process.Content of directory on path {path} cannot be listed.WaitIOCompletion call failed. HRESULT = {code}'. File/External table name: {path}
これらの一般的なストレージ アクセス エラーは、クエリの実行時に表示されます。 この問題は、あるワークスペースのユーザーで発生しても、ほかのワークスペースでは正常に機能する場合があります。 この動作は、トークン サイズが原因で予想されます。
PowerShell で次のコマンドを実行して、Microsoft Entra トークンの長さを確認します。 -ResourceUrl パラメータの値は、非パブリック クラウドでは異なります。 トークンの長さが 11000 以上に近い場合は、「軽減策」セクションを参照してください。
(Get-AzAccessToken -ResourceUrl https://database.windows.net).Token.Length
対処法:
推奨される回避策は次のとおりです。
- ストレージ アクセス制御に関する記事で説明されているように、マネージド ID ストレージの認可に切り替えます。
- セキュリティ グループの数を減らします (セキュリティ グループの数が 90 以下になると、互換性のある長さのトークンが生成されます)。
- セキュリティ グループの数を 200 以上に増やします (トークンの構造が変わると、グループの完全なリストではなく MS Graph API URI が含まれるようになります)。 これは、新しく作成されたグループにユーザーを追加する必要が生じた後に、マネージド グループに従ってダミー/人工のグループを追加することで実現できます。
ビューのクエリを実行すると予期しない結果が表示される
ビューの作成後に基となるスキーマが変更されたビューに対してクエリを実行すると、予期しない結果が発生する可能性があります。 これは、ビューが、変更されたか、存在しなくなった列またはオブジェクトを参照していることを意味します。 これを解決するには、基になるスキーマの変更に合わせてビュー定義を手動で調整する必要があります。
回避策: ビュー定義を手動で調整します。
最近終了した既知の問題
| Synapse コンポーネント | 問題 | Status | 解決した日 |
|---|---|---|---|
| Azure Synapse サーバーレス SQL プール | Microsoft Entra 認証を使用したクエリが 1 時間後に失敗する | 解決済み | 2023 年 8 月 |
| Azure Synapse サーバーレス SQL プール | OPENROWSET を使って Cosmos DB データを読み取るときのクエリ エラー | 解決済み | 2023 年 3 月 |
| Azure Synapse Apache Spark プール | パイプラインでノートブックの使用中に、Apache Spark 用の Azure Synapse 専用 SQL プール コネクタを使用した Synapse Spark から SQL 専用プールへの書き込みが失敗しました | 解決済み | 2023 年 6 月 |
| Azure Synapse Apache Spark プール | ストレージ アカウントの調整により、エラー コード 503 で特定の Spark ジョブまたはタスクが早期に失敗する | 解決済み | 2023 年 11 月 |
| Azure Synapse Apache Spark プール | Spark 3.4 ランタイムで Synapse 専用 SQL プール コネクタを使用した LIKE 句を伴うクエリ エラー | 解決済み | 2024 年 10 月 |
Azure Synapse Analytics サーバーレス SQL プールに関する最近クローズした既知の問題の概要
Microsoft Entra 認証を使用したクエリが 1 時間後に失敗する
1 時間以上アクティブなままの Microsoft Entra 認証を使用した SQL 接続は失敗します。 これには、Microsoft Entra パススルー認証と、Microsoft Entra ID とやり取りする CREATE EXTERNAL PROVIDER などのステートメントを使用して行う、ストレージに対するクエリ実行が含まれます。 これは、SSMS や ADS のクエリ エディターなど、接続をアクティブなまま保持するすべてのツールに影響します。 Synapse Studio のように、新しい接続を開いてクエリを実行するツールは影響を受けません。
状態: 解決済み
OPENROWSET を使って Azure Cosmos DB データを読み取るときのクエリ エラー
OPENROWSET を使ってサーバーレス SQL プールから Cosmos DB 分析ストアに対してクエリを実行すると、次のエラー メッセージで失敗します。
Resolving CosmosDB path has failed with error 'bad allocation'.
状態: 解決済み
Azure Synapse Analytics Apache Spark プールに関する最近クローズした既知の問題の概要
パイプラインでノートブックの使用中に、Apache Spark 用の Azure Synapse 専用 SQL プール コネクタを使用した Synapse Spark から SQL 専用プールへの書き込みが失敗しました
Apache Spark 用の Azure Synapse 専用 SQL プール コネクタを使用し、パイプラインでノートブックを使用して Azure Synapse 専用プールへ書き込むと、次のエラー メッセージが表示されます。
com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: COPY statement input file schema discovery failed: Cannot bulk load. The file does not exist or you don't have file access rights.
状態: 解決済み
ストレージ アカウントの調整により、エラー コード 503 で特定の Spark ジョブまたはタスクが早期に失敗する
2023 年 10 月 3 日から 2023 年 11 月 16 日の期間、Azure Synapse Analytics Apache Spark プールでは、ストレージ API の制限しきい値を超えたことが原因で Spark ジョブまたはタスクのエラーがまれに発生する可能性がありま。
状態: 解決済み
Spark 3.4 ランタイムで Synapse 専用 SQL プール コネクタを使用した LIKE 句を伴うクエリ エラー
オープン ソースの Apache Spark 3.4 では、特殊文字をエスケープする問題が発生しましたが、Synapse SQL ではエスケープ キーワードはサポートされていません。 お客様が Apache Spark 用の Azure Synapse 専用 SQL プール コネクタを使用すると、Synapse SQL に対して無効な SQL クエリが生成され、Synapse Spark ノートブックまたはバッチ ジョブで次のようなエラーがスローされる可能性があります。
com.microsoft.spark.sqlanalytics.SQLAnalyticsConnectorException: com.microsoft.sqlserver.jdbc.SQLServerException: Parse error at line: 1, column: XXX: Incorrect syntax near ''%test%''
状態: 解決済み