一般的なクエリ エラーのトラブルシューティング
適用対象: Azure Synapse Analytics
注:
Azure Synapse Analytics で現在アクティブになっている、または最近解決された既知の問題の一覧を確認してください。
次のガイダンスを使用して、Azure Synapse専用 SQL プールに対してクエリを実行するときに発生する一般的なエラー、エラー、および例外のトラブルシューティングを行います。
一般的なエラー
Error | 原因 | 軽減策 |
---|---|---|
ファイル グループ 'PRIMARY' のディスク領域が不足しているため、データベース 'Distribution_<NN>' に新しいページを割り当てませんでした。 | 行ストア インデックス ( 列ストアではなく) またはヒープを持つテーブルが、少なくとも 1 つのディストリビューションで使用可能な領域を超えています。 | - データベースの最大サイズを増やします。 - テーブルのスキューを評価します。 |
エラー 8632 - 内部エラー: 式サービスの制限に達しました。 クエリで複雑な可能性のある式を探し、それらを簡略化してください。 | クエリが複雑すぎて最適化が行われません。 | クエリを複数の手順に分割します。 |
アクセスできないファイルやメモリまたはディスク領域が不足しているため、データベース 'Distribution_<NN>_Cache' を開くことができません。 | サービス正常性の問題を示します。 | 専用 SQL プールを一時停止して再開します。 |
現在のリソース クラスと DWU に割り当てられた合計から残りのメモリを超えるため、列ストアの圧縮に n KB を割り当てることができません。 | 書き込み操作用のメモリが不足しています。 | - ユーザーのリソース クラスを増やします。 - SLO を一時的に増やすことを検討してください。 |
内部エラー (5123、50) | 大量の IO 操作が原因で発生します。 | - ユーザーのリソース クラスを増やします。 - テーブルのパーティション数を減らします。 - CCI テーブルをリビルドします。 |
クエリの実行に失敗しました。 エラー: サーバー '{NAME}' の MSDTC が使用できません | グローバル トランザクションを管理するサービスが適切に機能していません。 | 直ちに軽減するために、専用 SQL プールを一時停止して再開します。 問題が再発する場合は、サポートにお問い合わせください。 |
110806;分散クエリに失敗しました: 実行タイムアウトの有効期限が切れています。 操作の完了前に経過したタイムアウト期間、またはサーバーが応答しない | 内部メタデータ取得タイムアウト。 | sys.pdw_table_mappingsへのクエリ参照は、パフォーマンスが高いsys.pdw_permanent_table_mappingsに置き換えます。 |
110806;分散クエリに失敗しました: ExecuteNonQuery には、開いている使用可能な接続が必要です。 接続の現在の状態が開いています。 | コンピューティング ノード間の接続の問題を示す内部クエリ エラー。 | - この問題は通常自己解決されるため、クエリを再試行してください。 - 問題が解決しない場合は、専用 SQL プールを一時停止して再開します。 - 問題の頻度が増える場合は、サポートにお問い合わせください。 |
110806;分散クエリに失敗しました: 操作は許可されていません。 | 通常、リソースの負荷を示す内部クエリ エラー。 | - この問題は通常自己解決されるため、クエリを再試行してください。 - 問題が解決しない場合は、専用 SQL プールを一時停止して再開します。 - 統計を更新 し、 CPI を再構築します。 - SLO を増やすことを検討してください。 SLO を増やした後も問題が解決しない場合は、サポートにお問い合わせください。 |
110806;分散クエリが失敗しました: 'PRIMARY' ファイル グループがいっぱいであるため、データベース 'tempdb' のオブジェクト '<ObjectName>' に領域を割り当てませんでした。 | クエリまたは一連のクエリが、少なくとも 1 つのコンピューティング ノードに入力されています tempdb 。 |
専用 SQL プールで tempdb エラーをトラブルシューティングする方法を参照してください。 |
110802;この操作が失敗する原因となった内部 DMS エラーが発生しました。 詳細: 管理者に問い合わせる場合は、このエラー ID を使用してください。 EID:(<ErrorID>) | リソース不足による DMS 操作中のクエリエラー。 | - ワークロードに合わせてユーザーのリソース クラスを増や します。 - tempdb の塗りつぶしを防ぐための軽減策を確認して実装します。 |
110802;この操作が失敗する原因となった内部 DMS エラーが発生しました。 ...Java 例外メッセージ: HdfsBridge::createRecordWriter - レコード ライターの作成時に予期しないエラーが発生しました: ClassCastException: | が、サポートされていないソースにEXTERNAL DATA SOURCE 対してネイティブ データ仮想化を使用して作成されるときに、ステートメント中にCREATE EXTERNAL TABLE AS SELECT 発生します。 |
外部データ ソースの作成時にを指定TYPE = Hadoop します。 |
110802;この操作が失敗する原因となった内部 DMS エラーが発生しました。 ...Java 例外メッセージ: HdfsBridge::CreateRecordReader - レコード リーダーの作成中に予期しないエラーが発生しました: ConnectException: 接続がタイムアウトしました。 | クエリを実行するためのメモリ リソースが不足しています。 | ワークロードに合わせてユーザーのリソース クラスを増や します。 |
100088: ターゲット DML テーブルがハッシュ パーティション分割されていないため、クエリ プロセッサでクエリ プランを生成できませんでした | サポートされていないラウンド ロビン分散テーブル DML シナリオ: - DELETE または UNIQUE キーを持つ PRIMARY RR から- UPDATE は、ターゲット テーブルで更新する行を決定するために、 などのROW_NUMBER RANK DENSE_RANK ランク付け関数を使用します。 |
- DELETE + PK/UK シナリオ: Drop PK/UK してから、重複する行を削除します。- UPDATE + ランク付け関数のシナリオ:
|
35386. エラー メッセージ: 現在のリソース クラスと DWU に割り当てられている合計から残りのメモリを超えるため、列ストアの圧縮に {NAME} 370216割り当てることができません | クラスター化列ストア インデックスを使用してテーブルを変更または管理しているクエリには、タスクを完了するのに十分なメモリがありません。 | - ワークロードに合わせてユーザーのリソース クラスを増や します。 - SLO を増やすことを検討してください。 |
予期しない動作
観測 | Recommendation |
---|---|
構文エラー。 | 専用 SQL プールに違いがあるため、 T-SQL 構文 リファレンスを確認してください。 |
主キーと一意キーは適用されません。 | 主キーと一意の制約では、Synapse Analytics では一貫性が強制されません。 ただし、クエリ オプティマイザーはキーを利用してクエリのパフォーマンスを向上させることができます。 |
USE ステートメントは失敗します。 | ステートメントは USE 、専用 SQL プールではサポートされていません。 接続文字列内の Synapse 専用 SQL プールに直接接続します。 |
取り消されたクエリまたは実行タイムアウト エラー。 | - クライアント アプリケーションで構成されているタイムアウト値を確認します。 - CREATE WORKLOAD GROUP でパラメーターを構成 QUERY_EXECUTION_TIMEOUT_SEC します。 |
一貫性がない、または予期しない結果。 | - データに特殊文字が含まれている場合、または異なるテキスト エンコードを使用する場合は、 や などの NCHAR Unicode データ型を NVARCHAR 使用します。- 句または JOIN 操作でクエリがWHERE 使用GETDATE() されているかどうかを確認します。 変数を使用して日付を格納し、それを変数に使用します。- クエリで 句または JOIN 操作で 関数がROW_NUMBER() WHERE 使用されているかどうかを確認します。 一時テーブルを使用して関数の結果を ROW_NUMBER() 保持し、他のテーブルと結合します。- 既定以外の照合順序を持つデータベースは、クエリの動作に影響を与え、サード パーティ製ツールと対話するときに予期しない結果が表示される可能性があります。 注: 専用 SQL プールの作成後に、既定のデータベース照合順序を変更することはできません。 照合順序のサポートの詳細については、「Azure Synapse Analytics 専用 SQL プールのデータベース照合順序のサポート」を参照してください。 |
予期しない重複する行。 | をPRIMARY KEY テーブルにドロップし、複製をチェックします。 |
クエリがハングするか、実行時間の長いクエリがあります。 | 専用 SQL プールでの低速クエリのトラブルシューティングに関する記事を参照してください。 |
推定クエリ プランでは、予期したとおりに関連するパーティションが削除されません。 | この動作は仕様です。 Control ノードによって生成された推定クエリ プランでは、シーク述語は考慮されませんが、コンピューティング ノード上の個々の分散プランでは考慮されます。 |
具体化されたビューでビューを参照できません。 | 具体化されたビューでは、他のビューのクエリはサポートされていません。 具体化されたビューの制限を確認します。 |
外部テーブルに対してクエリを実行するときの一貫性のない期間。 | 外部テーブルは、エンド ユーザー クエリには最適ではありません。 代わりに、クエリを実行するために 永続的なテーブルにデータを読み込む か、ワークロードを切り替えて、より一貫性のあるエクスペリエンスを実現するために サーバーレス プール を使用することを検討してください。 |
リソース
- DMV sys.dm_pdw_errors に対してエラーのクエリを実行する
- Azure Synapse Analytics の専用 SQL プール (旧称 SQL DW) のトラブルシューティング
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示