すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:よくある質問

最終更新日:Jan 07, 2025

このトピックでは、プロキシマCEに関するよくある質問に対する回答を提供します。

Proxima CEで使用されるリソースは何ですか?

アカウントが属するMaxComputeプロジェクト内のリソースは、Proxima CEによって使用されます。

入力テーブルのベクトルは、MaxComputeでサポートされているBINARY型にできますか。

いいえ、入力テーブルのベクトルはBINARY型にすることはできません。 Proxima CEは、docテーブルのベクトル列をインデックスに変換することによってインデックスを作成します。 デフォルトでは、docテーブルのベクトル列はSTRING型のみをサポートします。 BINARYタイプはサポートされていません。 ただし、Proxima CEは -binary_to_intコマンドラインパラメーターを提供します。 BINARY型のデータをINT型に変換するかどうかを指定します。 たとえば、入力データの区切り文字としてカンマ (,) を使用する場合、このパラメーターは次のように有効になります。

  • -binary_to_intがfalseに設定されている場合、入力データは1,1、1,1、1,1、... になります。

  • -binary_to_intがtrueに設定されている場合、入力データは12345,13423、13325、... になります。

データ型変換機能を使用すると、0と1で構成されるN個のバイナリ値をN個の32ビットの整数に変換できます。 このようにして、作成されるインデックスのサイズが縮小される。

-column_numおよび-row_numパラメーターを指定するにはどうすればよいですか。

Proxima CEは分散エンジンであり、MaxCompute MapReduceと連携して大量のベクトルデータをオフラインモードで処理します。 ビルドプロセスでは、システムはdocテーブルを列に分割し、列ごとにインデックスを作成します。 シークプロセスでは、システムは、検索のためにクエリテーブルを行に分割する。 システムは、2つのプロセスを実装して、大量のデータからベクトルデータを検索します。

ユーザーの場合:

  • 列はビルドプロセスに影響します。 多数の列が作成されると、各列のインデックスサイズが小さくなり、1つの列の検索速度が速くなります。 これにより、ビルドプロセスが高速化されますが、使用されるクラスターマシンリソースの量が増加します。

  • 行はシークプロセスに影響します。 多数の行が作成された場合、各行のクエリの数は少なく、1行の検索速度は速くなります。 これは、シークプロセスを加速するが、使用されるクラスタマシン資源の量を増加させる。

行と列の分割に関する次の制限に注意してください。

  • クラスターリソースの使用に関するデフォルトの制限。 クラスターリソースの使用に関するデフォルトの制限については、アカウントが属するMaxComputeプロジェクトの所有者に連絡する必要があります。

  • MapReduceインスタンスの制限。 MaxCompute MapReduceでは、最大数の99,999インスタンスを使用してreduceタスクを実行できます。 ビルドプロセスでは、インスタンス数はcolumn_numパラメーターで指定されます。 シークプロセスでは、インスタンスの数は次の式column_num × row_numを使用して決定されます。 上記の式を使用して計算された値が未満99999であることを確認する必要があります。

上記のアーキテクチャおよび関連する制限を考慮して、入力パラメーターに基づいてProxima CEによって自動的に計算された行および列の構成を使用することを推奨します。 詳細については、「マルチカテゴリ検索」をご参照ください。

プロキシマCEによって計算された行および列の数は、通常の動作を保証することができる。 クエリの高速化が必要な場合は、行と列を追加できます。 クラスターリソースが不足している場合は、行と列の数を減らすことができます。 MaxComputeプロジェクトの実際の状況とで説明されている原則に基づいて、行と列を追加するか削除するかを決定できます。タスクの実行を加速するにはどうすればよいですか?.

タスクの実行を加速するにはどうすればよいですか?

  • マルチカテゴリシナリオでは、2種類のカテゴリがタスクに関与します。小さなカテゴリと大きなカテゴリです。 各小さなカテゴリには100万 (設定可能なデフォルトのしきい値) 未満のドキュメントがあり、各大きなカテゴリには100万を超えるドキュメントがあります。 すべての小さなカテゴリに対して、システムは線形検索方法を使用します。 小さなカテゴリからのクエリを高速化するには、-category_row_numおよび -category_col_numのパラメーターを設定します。 大きなカテゴリからのクエリを高速化するには、-row_numおよび -column_numのパラメーターを設定します。 加速の目的のために、一般的な原則は列と行を追加することです。 列を追加すると、各列のインデックスのサイズが小さくなり、1つの列の検索速度が速くなります。 行を追加すると、各行からのクエリの数が減り、データの各バッチの検索速度が速くなります。 ただし、これらの場合、より多くのリソースが消費されます。 ビジネスとリソースの分析に基づいて、追加操作を実行するかどうかを決定する必要があります。 詳細については、「マルチカテゴリ検索」をご参照ください。

  • マルチカテゴリ以外のシナリオでは、-row_numパラメーターと -column_numパラメーターを設定して、タスク全体の同時実行性を向上させることができます。

クエリ結果の数が指定された数より少ないのはなぜですか。

入力データが有効で、システムが期待どおりに実行されることを確認した場合、問題はdocテーブルのデータにある可能性があります。 デフォルトでは、Proxima CEはHierarchical Navigable Small World (HNSW) グラフアルゴリズムを使用してインデックスを作成します。 この場合、グラフ内のオブジェクトはリンクされなくてもよい。 その結果、取得された結果の数は指定された数より少なくなります。 解決策:

  • リコール率を下げます。 この方法を使用して問題を完全に解決することはできません。 グラフリンクの問題が基礎となるアルゴリズムによって引き起こされる場合、取得される結果の数は、リコール率に関係なく、指定された数 (この例では200) と同じにすることはできません。 特別なケースでリコール率を下げると、他のベクトルの取得にも影響を与える可能性があります。 この方法を使用する前に、影響を評価する必要があります。

  • インデックス作成アルゴリズムを変更します。 たとえば、階層クラスタリング (HC) を使用してグラフを作成する場合、-algo_modelコマンドラインパラメーターを設定して、インデックス作成アルゴリズムを指定できます。

  • 上位Kの結果を補完します。 Proxima 2.4以降のバージョンでは、HNSWグラフアルゴリズムを使用する場合、設定 {"proxima.hnsw.searcher.force_padding_result_enable" : True} を追加して、検索結果に基づいて指定された上位K件の結果を補完できます。 この方法は、極端な場合、類似性検索に悪影響を及ぼす。 この方法を使用する前に、実際のビジネスに基づいて影響を評価する必要があります。

プロキシマCEのコサイン距離を設定できますか?

プロキシマCEはコサイン距離をサポートし、内積検索を最適化します。 詳細については、「内積とコサイン距離」をご参照ください。

送信されたProxima CEタスクの実行が遅いのはなぜですか?

Proxima CEタスクはMaxCompute MapReduceジョブで実行されます。 タスクがコンパイルされて正常に実行される場合、問題はMaxComputeのスケジューリングとリソースにある可能性があります。 MaxCompute開発者コミュニティのDingTalkグループに参加するには、DingTalkグループ (ID: 11782920) を検索して、MaxComputeテクニカルサポートエンジニアに連絡して支援を求めることができます。

一時テーブルの作成に失敗するのはなぜですか?

一時テーブルの作成に失敗した場合、ほとんどの場合、無効なテーブル名: xxx.yyyというエラーメッセージが表示されます。 出力テーブルの名前が不正なためです。

Proxima CEタスクの入出力テーブルの名前は、MaxComputeの命名規則に準拠している必要があります。 名前には、MaxComputeでは特殊文字と見なされるピリオド (.) を含めることはできません。 名前にピリオド (.) が含まれている場合、後続のプロセスは失敗します。 ほとんどの場合、この問題は、出力テーブルの名前がxxx.output_table_name形式であるために発生します。

複数のタスクを同時に実行できますか?

Proxima CEでは、同じdocテーブルを含むタスクを同時に実行することはできません。 このようなタスクを同時に実行すると、インデックスの上書きの問題が発生する可能性があります。 たとえば、タスクAのインデックスが作成された場合、タスクBのインデックスは作成されたインデックスによって上書きされます。 その結果、様々な問題が発生する。 一般的な問題:

  • 基になるOSSボリュームファイルシステムに関連するエラーが報告されます。

  • ビルドプロセスが失敗し、Java Native Interface (JNI) ベースのインデックス書き込みに関連するエラーが報告されます。

  • シークプロセスが失敗し、JNIベースのインデックスロードに関連するエラーが報告されます。

オフラインタスクがオンラインタスクに影響するのはなぜですか?

一般的な原因は、オフラインタスクとオンラインタスクが同じクラスターで実行されることです。 一般的なケースでは、さまざまな種類のMaxComputeジョブがクラスターでハイブリッドに実行されます。 クラスターの下層は、オフラインタスクとオンラインタスクで共有されます。 したがって、オフラインタスクは大量のクラスターリソースを占有する可能性があります。 その結果、オンラインタスクは十分なリソースを取得できず、これらのタスクはゆっくりと実行され、失敗することさえあります。 解決策:

  • オフラインタスクのリソース使用を制限します。 Proximaオフラインタスクの行数と列数を指定することで、オフラインタスクの同時実行を制限できます。 MaxComputeコンソールでMaxComputeプロジェクトに制限を課すこともできます。 これらの操作は、オフラインタスクの実行を遅くします。

  • さまざまな期間にオンラインとオフラインのタスクを実行してみてください。 新しいリソースを申請することもできます。

実行ログとLogviewとは何ですか? それらの違いは何ですか?

  • ログの実行

    テクニカルサポートエンジニアは通常、DataWorksノードの実行後に生成された情報を含む実行ログを使用します。 実行ログ情報をコピーして、トラブルシューティングのためにテクニカルサポートエンジニアに送信できます。

    MaxComputeクライアントodpscmdを使用してスクリプトを実行する場合、MaxComputeクライアントでも実行ログが生成されます。 クライアント上のすべてのログをコピーして、テクニカルサポートエンジニアに送信できます。 ログをログファイルにリダイレクトし、そのファイルをテクニカルサポートエンジニアに送信することもできます。 cmd

  • Logview

    Logviewは、ジョブを送信した後にMaxComputeジョブを表示およびデバッグするために使用できるツールです。 Proxima CEを使用する場合、SQLジョブやMapReduceジョブなどの関連ジョブが実行されるときに、Logviewを使用してログステータス情報を視覚化できます。 これにより、MaxComputeで実行されているSQLジョブ、MapReduceジョブ、Graphジョブなどのジョブのステータスを表示し、デバッグ中に発生した問題を特定できます。 詳細については、「LogViewを使用したジョブ情報の表示」をご参照ください。

タスクに対して "ERROR: KILLED" がログに記録されている場合はどうすればよいですか?

次のまたは同様の情報がログに記録されます。Kill log次の理由でタスクが終了する可能性があります。

  • タスクは長期間実行されます。 SQLタスクがMaxComputeで24時間以上実行されると、自動的に強制終了されます。 odps.sql.job.max.time.hoursを72に設定できます。 この方法で、最大72時間タスクを実行できます。

    set odps.sql.job.max.time.hours=72;
  • クラスターが過負荷になり、リソースがタスクによって長時間プリエンプトされます。 その結果、タスクは殺されます。

  • タスクは手動で強制終了されます。 プロジェクトの所有者またはプロジェクト管理者ロールが割り当てられた他のユーザーによってタスクが強制終了されたかどうかを確認できます。

ほとんどの場合、タスクが殺された場合は、再実行できます。 ただし、クラスターがオーバーロードされている場合は、次のいずれかの方法を使用することを推奨します。

  • -odps_task_priorityパラメーターを設定して、タスクを優先します。 詳細については、「オプションパラメーター」をご参照ください。

    重要

    この方法は危険です。 この方法を使用すると、タスクは他の優先度の高いジョブに割り当てられているリソースを先取りする可能性があります。 プロジェクトの所有者または関係者に連絡し、プロジェクトのクラスターで優先度の高いオンラインまたはオフラインタスクが実行されていないことを確認する必要があります。

  • 優先度の高いタスクのリソース使用量が減少するまで待ちます。 次に、プロキシマCEタスクを再実行します。

-odps_task_priorityで指定されたタスク優先度が有効にならないのはなぜですか。

プロジェクトのベースライン優先度を設定すると、-odps_task_priorityパラメーターで指定された優先度がベースライン優先度より高い場合は無効になります。 ベースライン管理の詳細については、「ベースラインの管理」をご参照ください。