Azure Synapse Analytics の既知の問題

このページでは、Azure Synapse Analytics の既知の問題と、その解決日または考えられる回避策を一覧で紹介します。 Azure サポート リクエストを送信する前に、このリストを確認して、発生している問題が既知であり、対処されているかどうかを確認してください。

Azure Synapse Analytics の詳細については、「Azure Synapse Analytics の概要」と「Azure Synapse Analytics の新機能」を参照してください。

アクティブな既知のイシュー

Azure Synapse Analytics 専用 SQL プールに関するアクティブな既知の問題の概要

Data Factory の Copy コマンドが失敗し、エラー "I/O デバイスのエラーのため要求を実行できませんでした" を出しました

Azure Data Factory のパイプラインでは、COPY INTO Transact-SQL ステートメントを使用して、専用 SQL プール テーブルに大規模なデータを取り込みます。 まれに、Azure Data Factory パイプラインでファイル分割が使用されるときに、CSV ファイルを専用 SQL プール テーブルに読み込むと、COPY INTO ステートメントが失敗することがあります。 ファイルの分割は、いくつかの大きい (1 GB 以上の) ファイルが単一のコピー タスクで読み込まれる場合に、その読み込みパフォーマンスを向上させるメカニズムです。 ファイル分割を有効にすると、各スレッドでファイルの一部を処理する複数の並列スレッドで、1 つのファイルを読み込むことができます。

回避策: 影響を受けるお客様は、Azure Data Factory でファイル分割を無効にする必要があります。

COPY INTO ステートメントが失敗し、エラー "内部 DMS エラーが発生し、この操作は失敗しました" を出しました (マネージド ID が使用される場合)

マネージド ID を使用して COPY INTO コマンドを使用する場合、長時間にわたるクエリの後でステートメントが失敗し、エラー メッセージ "内部 DMS エラーが発生し、この操作は失敗しました" が出される可能性があります。

回避策: 影響を受けるお客様は、共有アクセス キーなど、ストレージ アカウントの代替認証方法を使用できます。

お客様はメトリックを使用して専用 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 を使って自動作成されたハッシュ分散テーブルへのインジェストはサポートされていません。 以前に、このサポートされていないシナリオを使用してデータを読み込んだお客様は、CREATE TABLE AS SELECT (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 サポート チームにお問い合わせください。

ARM デプロイで TDE ゲートウェイ タイムアウトを有効にする

TDE の更新 (Transparent Data Encryption) は、同期操作として内部的に実装されるもので、タイムアウトがあり、これを超えている場合があります。 タイムアウトを超えていても、背後の TDE 操作はほとんどの場合成功していますが、ARM テンプレートの後続操作は拒否されることになります。

回避策: この問題を軽減するには、2 つの方法があります。 推奨されるオプションは、ARM テンプレートを複数のテンプレートに分割して、いずれかのテンプレートに TDE 更新が含まれるようにすることです。 このアクションにより、タイムアウトの可能性が減少します。その他のオプションは、数分後にデプロイを再試行することです。 待機時間中、ほぼ TDE 更新操作は成功していると考えられるので、2 回目にテンプレートを再デプロイすることで、以前に拒否された操作が実行される可能性があります。

タグの更新が失敗したと表示される

Azure portal やその他のメソッドを使用して専用 SQL プールのタグを変更すると、変更が正常に行われた場合でもエラー メッセージが表示される場合があります。

回避策: タグに対する変更が成功したことを確認し、必要に応じてエラー メッセージを無視または抑制できます。

プロキシ接続では、ゲートウェイが原因でエラーが発生する可能性があります

Azure ネットワーク境界の外部から接続を確立すると、Synapse ワークスペースの既定の 接続ポリシー に従って、すべての接続がゲートウェイ経由でプロキシされます。 Synapse ワークスペースでプライベート エンドポイントを使用する場合も同様です。 このポリシーにより、専用プールと通信するときの待機時間が長くなり、スループットが低下し、ゲートウェイの停止の影響を受ける可能性があります。

回避策: 現時点では、シナリオに対する回避策はありません。

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 テンプレートが失敗する

ARM テンプレート、Bicep ファイル、または直接 REST API PUT 操作を使用して、Synapse ワークスペースのパブリック ネットワーク アクセス設定やファイアウォール規則を変更すると、操作が失敗する可能性があります。

回避策: この問題は、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 Alias を生成できません。

親リソース: Microsoft.Synapse/workspaces

子リソース: Microsoft.Synapse/workspaces/trustedServiceByPassConfiguration

Azure portal は、子リソースの PUT API に直接 PUT 要求を行います。そのため、Azure portal を (親の Microsoft.Synapse/workspaces API の外部で行われた他の API 要求と共に、Deny またはその他の実行可能な Azure Policy Effect を介して) 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'

この問題を確認するには、次の条件を満たしている必要があります。

1. Azure Cosmos DB 分析ストアへの接続には、プライベート エンドポイントを使います。
2. クエリを再試行すると成功します。

回避策: エンジニアリング チームはこの動作を認識しています。また、簡単な軽減策として次のアクションを実行できます。

1. 失敗したクエリを再試行します。 これで、期限切れのトークンが自動的に更新されます。
2. プライベート エンドポイントを無効にします。 この変更を適用する前に、会社のセキュリティ ポリシーを満たしていることをセキュリティ チームに確認してください。

Azure Cosmos DB 分析ストア ビューで、列に誤った属性が反映される

Cosmos DB 分析ストアを介して Azure Synapse サーバーレス プールでビューを使用しているときに、Cosmos DB 分析ストア内のファイルが変更されると、その変更は SELECT ステートメントに正しく反映されず、お客様はビューでそれを使用することになります。 その結果、属性が結果の異なる列に誤ってマップされます。

回避策: エンジニアリング チームはこの動作を認識しています。また、簡単な軽減策として次のアクションを実行できます。

1. 列の名前を変更して、ビューを再作成します。
2. 可能な場合は、ビューの使用を避けてください。

資格情報が使用されている場合、データベーススコープの資格情報の変更が失敗する

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 が含まれるようになります)。 これは、新しく作成されたグループにユーザーを追加する必要が生じた後に、マネージド グループに従ってダミー/人工のグループを追加することで実現できます。

ビューのクエリを実行すると予期しない結果が表示される

ビューの作成後に基となるスキーマが変更されたビューに対してクエリを実行すると、予期しない結果が発生する可能性があります。 これは、ビューが、変更されたか、存在しなくなった列またはオブジェクトを参照していることを意味します。 これを解決するには、基になるスキーマの変更に合わせてビュー定義を手動で調整する必要があります。

回避策: ビュー定義を手動で調整します。

7,500 文字を超えるクエリが Log Analytics に表示されない場合がある

長さが 7,500 文字を超えるクエリが、Log Analytics の SynapseBuiltinSqlPoolRequestsEnded テーブルにキャプチャされない場合があります。

回避策:

推奨される回避策は次のとおりです。

• Synapse サーバーレス SQL プールの sys.dm_exec_requests_history ビューを使用して、クエリの実行履歴の詳細にアクセスします。
• 可能であれば、クエリの長さを 7,500 文字未満にするようにリファクタリングします。

Azure Synapse Apache Spark プールのアクティブな既知の問題の概要

Spark セッション (カスタム Python ライブラリを使用) の開始に通常よりも時間がかかっています

Python ライブラリ (requirements.txt または .whl) が Spark プールにアタッチされている場合、セッションの起動時間に影響する既知の問題があります。 お客様は、セッションの起動時間が断続的に遅くなります。 これは、Fabric と Synapse の両方に影響を与えます。

回避策: 軽減策は、次のリージョンに適用されています。 この軽減策により、セッションの起動は大幅に改善されましたが、元のベースラインよりも 1.5 倍遅くなる可能性があります。

最近クローズした既知の問題

Azure Synapse Analytics サーバーレス SQL プールに関する最近クローズした既知の問題の概要

Microsoft Entra 認証を使用したクエリが 1 時間後に失敗する

1 時間以上アクティブなままの Microsoft Entra 認証を使用した SQL 接続は失敗します。 これには、Microsoft Entra パススルー認証と、Microsoft Entra ID とやり取りする CREATE EXTERNAL PROVIDER などのステートメントを使用して行う、ストレージに対するクエリ実行が含まれます。 これは、SSMS (SQL Server Management Studio) と ADS (Azure Data Studio) のクエリ エディターなど、接続をアクティブに保つすべてのツールに影響します。 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%''

状態: 解決済み

関連コンテンツ

• Synapse Studio のトラブルシューティング
• Azure Synapse Analytics のサーバーレス SQL プールのトラブルシューティング
• Azure Synapse Analytics のサーバーレス SQL プールのベスト プラクティス
• 専用 SQL プールの低速クエリのトラブルシューティング