このトピックでは、パラメータ名、パラメータの説明、影響範囲など、フラグパラメータについて詳しく説明します。 [パラメータ] ページでパラメータを検索できます。
カテゴリ | 影響範囲 | パラメータ | 説明 | 有効値 | 影響を受ける SQL 文と関数 |
エコシステム | セッション | console.sql.result.instancetunnel | InstanceTunnel を有効にするかどうかを指定します。Tunnel コマンドの詳細については、「使用上の注意」をご参照ください。 |
| SELECT |
スケジューリング | セッション | odps.stage.mapper.mem | 各 Map ワーカーのメモリサイズ。 | 有効値: 256 MiB ~ 12288 MiB。デフォルト値: 1024 MiB。 | ALL |
スケジューリング | セッション | odps.stage.reducer.mem | 各 Reduce ワーカーのメモリサイズ。 | 有効値: 256 MiB ~ 12288 MiB。デフォルト値: 1024 MiB。 | ALL |
スケジューリング | セッション | odps.stage.joiner.mem | 各 Join ワーカーのメモリサイズ。 | 有効値: 256 MiB ~ 12288 MiB。デフォルト値: 1024 MiB。 | ALL |
スケジューリング | セッション | odps.stage.mem | 指定された MaxCompute ジョブの全ワーカーの合計メモリサイズ。 odps.stage.mapper.mem、odps.stage.reducer.mem、odps.stage.joiner.mem パラメータよりも優先順位が低くなります。 | 有効値: 256 MiB ~ 12288 MiB。デフォルト値なし。 | ALL |
スケジューリング | セッション | odps.stage.mapper.split.size | 各 Map ワーカーの入力データ量。入力ファイルの分割サイズです。このパラメータを使用して、各 Map ステージのワーカー数を間接的に制御できます。 説明 このパラメータを設定する際は、SQL 文で | 単位: MiB。デフォルト値: 256 MiB。 | ALL |
スケジューリング | セッション | odps.sql.split.size | テーブルレベルの並列処理におけるデータの単一シャードのサイズ。 | 単位: MiB。 例: | ALL |
スケジューリング | セッション | odps.sql.split.row.count | テーブルレベルの並列処理における単一シャードの行数。 説明 内部テーブル、非トランザクションテーブル、非クラスタテーブルのみに使用できます。 | 有効値: このパラメータの値は正の整数でなければなりません。 例: | ALL |
スケジューリング | セッション | odps.sql.split.dop | テーブルレベル処理の並列度。 説明 内部テーブル、非トランザクションテーブル、非クラスタテーブルのみに使用できます。 | 有効値: このパラメータの値は正の整数でなければなりません。 例: | ALL |
スケジューリング | セッション | odps.stage.reducer.num | 各 Reduce ステージのワーカー数。 説明 このパラメータを設定する際は、SQL 文で | - | ALL |
スケジューリング | セッション | odps.stage.joiner.num | 各 Join ステージのワーカー数。 説明 このパラメータを設定する際は、SQL 文で | - | ALL |
スケジューリング | セッション | odps.stage.num | 指定された MaxCompute ジョブの同時ワーカーの総数。 odps.stage.mapper.split.size、odps.stage.reducer.num、odps.stage.joiner.num パラメータよりも優先順位が低くなります。 説明 このパラメータを設定する際は、SQL 文で | - | ALL |
スケジューリング | プロジェクト | odps.instance.priority.enable | サブスクリプション計算リソースを使用するプロジェクトのジョブ優先機能を有効にするかどうかを指定します。ジョブ優先機能の詳細については、「ジョブの優先順位」をご参照ください。 |
説明 プロジェクトオーナーまたは Super_Administrator ロールが割り当てられたユーザーのみ、このコマンドを実行して優先機能を有効にできます。 | ALL |
SQL | セッション | odps.sql.reshuffle.dynamicpt | 動的パーティショニングを有効にするかどうかを指定します。動的パーティショニングは、多数の小さなファイルの生成を防ぎます。 |
説明 少数の動的パーティションが生成される場合は、データスキューを防ぐために、このパラメータを False に設定することをお勧めします。 |
|
SQL | セッション | odps.sql.udf.getjsonobj.new | GET_JSON_OBJECT 関数が値を返すときに元の文字列を保持するかどうかを指定します。 説明 詳細については、「文字列関数」をご参照ください。
|
| UDF |
SQL | セッション | odps.sql.udf.jvm.memory | ユーザー定義関数 (UDF) 用の Java 仮想マシン (JVM) ヒープの最大メモリサイズです。 UDF を使用してメモリ内で大量のデータが計算およびソートされる場合、メモリ不足 (OOM) エラーが発生する可能性があります。 この場合、このパラメーターの値を増やすことができます。 ただし、OOM エラーを防ぐために、ビジネス要件に基づいて UDF コードを最適化する必要があります。 | 有効な値: 256 MiB ~ 12288 MiB。 デフォルト値: 1024 MiB。 | UDF |
SQL | セッション | odps.function.timeout | UDF のタイムアウト期間です。 | 有効な値: 0s ~ 3600s 。デフォルト値: 600s 。 | UDF |
SQL | セッション | odps.sql.session.resources | ユーザー定義型(UDT)によって参照されるリソース。複数のリソースを指定し、コンマ(,)で区切ることができます。 参照されるリソースの詳細については、「概要」をご参照ください。 | アップロードされたリソース。 | UDT |
SQL | セッション | odps.sql.udt.display.tostring | 出力が UDT であるすべての列の Wrap で java.util.Objects.toString(...) メカニズムを有効にするかどうかを指定します。 |
| UDT |
SQL | セッション | odps.sql.session.java.imports | UDT によって参照される Java パッケージ。複数の Java パッケージを指定し、コンマ (,) で区切ることができます。 Java パッケージの詳細については、「概要」をご参照ください。 | アップロードされた Java パッケージ。 | UDT |
SQL | セッション | odps.sql.skewjoin | ロングテールを回避するために SKEWJOIN 機能を有効にするかどうかを指定します。 |
|
|
SQL | セッション | odps.sql.skewinfo | SKEWJOIN が実行されるキーと値。詳細については、「データスキューチューニング」をご参照ください。 | - |
|
SQL | セッション | odps.sql.udf.ppr.deterministic | UDF のパーティションプルーニングを有効にするかどうかを指定します。パーティションプルーニングの詳細については、「WHERE 句 (WHERE_condition)」をご参照ください。 |
| UDF |
SQL | セッション | odps.sql.udf.ppr.to.subquery | パーティションプルーニングの実行中に結果のバックフィルでエラーが発生した場合に、そのエラーを無視するかどうかを指定します。パーティションプルーニングの詳細については、「SELECT 構文」の「WHERE 句 (where_condition)」セクションをご参照ください。 |
| UDF |
SQL | セッション | odps.optimizer.enable.range.partial.repartitioning | 範囲クラスタテーブルのシャッフル削除機能を有効にするかどうかを指定します。 |
|
|
SQL | セッション | odps.optimizer.merge.partitioned.table | クエリが繰り返し同じパーティションテーブルを使用する場合、このパラメーターを 設定 して、システムがパーティションテーブルをマージできるようにすることで、パーティションテーブルに対する IO 操作を最小限に抑え、パフォーマンスを向上させることができます。 |
| SELECT |
SQL | セッション | odps.optimizer.skew.join.topk.num | オプティマイザーが集約操作を実行するときに取得するホットキー値の数です。詳細については、「SKEWJOIN HINT」をご参照ください。 | - | SKEWJOIN HINT |
SQL | セッション | odps.optimizer.stat.collect.auto | Freeride 機能を有効にするかどうかを指定します。 Freeride 機能が有効になっている場合、テーブルの列の統計データが自動的に収集されます。 オプティマイザ情報の収集方法の詳細については、「オプティマイザ」をご参照ください。 |
|
|
SQL | セッション | odps.optimizer.stat.collect.plan | 特定の列の特定の列統計メトリックを収集するために使用されるコレクションプランです。オプティマイザ情報の収集方法の詳細については、「オプティマイザ」をご参照ください。 | - |
|
SQL | セッション | odps.sql.external.net.vpc | 外部テーブルに対して VPC (Virtual Private Cloud) を有効にするかどうかを指定します。詳細については、「」をご参照ください。 外部テーブルに対して Virtual Private Cloud(VPC) を有効にするかどうかを指定します。詳細については、「、および Hologres 外部テーブル」をご参照ください。 |
| CREATE TABLE |
SQL | セッション | odps.sql.groupby.position.alias | [GROUP BY] 句で整数定数を選択文の列番号として使用するかを指定します。 |
|
|
SQL | セッション | odps.sql.groupby.skewindata | GROUP BY 句のアンチスキュー機能を有効にするかどうかを指定します。 |
| GROUP BY |
SQL | セッション | odps.sql.orderby.position.alias | ORDER BY 句で整数定数を選択文の列番号として使用できるかどうかを指定します。 |
|
|
SQL | セッション | odps.sql.mapjoin.memory.max | MAPJOIN 文が実行されるときにメモリに読み取られる小さなテーブルのサイズです。単位:MiB。 説明 このパラメーターは、タスク レベルでの合計メモリ グローバル制限の対象にもなります。同じタスク内の複数の小さなテーブルの場合、合計メモリ グローバル上限は | 有効な値:0 MiB ~ 8192 MiB。 | 結合 |
SQL | セッション | odps.sql.distributed.map.join.memory.max | MAPJOIN 文が実行されるときの HashTableBuilder の各インスタンスのメモリサイズです。デフォルト値は 2048 です。単位:MiB。 | 有効な値:0 MiB ~ 8192 MiB。 | 結合 |
SQL | セッション | odps.sql.python.version | SQL 文が実行される Python のバージョン。 |
|
|
SQL | セッション | ODPS SQL SELECT の出力フォーマット | MaxCompute クライアントの戻り結果でテーブルヘッダーを表示するかどうかを指定します。 MaxCompute クライアントの使用方法の詳細については、「MaxCompute クライアント (odpscmd)」をご参照ください。 |
| すべて |
SQL | セッション | odps.sql.unstructured.data.oss.use.https | 外部テーブルにアクセスする際に、基盤レイヤーで HTTPS を使用してデータを取得するメカニズムを有効にするかどうかを指定します。Object Storage Service (OSS) 外部テーブルの詳細については、「OSS 外部テーブルを作成する」をご参照ください。 |
| すべて |
SQL | セッション | 10 進数から文字列への変換時に末尾のゼロを削除するかどうか | データ型が DECIMAL の場合に、小数点以下の末尾のゼロを削除するかどうかを指定します。デフォルト値は |
| キャスト |
SQL | セッション | odps.sql.unstructured.tablestore.put.row | Tablestore 外部テーブルにデータを書き込むために PutRow 操作を呼び出すかどうかを指定します。 説明 PutRow の詳細については、「PutRow」をご参照ください。 |
| すべて |
SQL | セッション | odps.sql.unstructured.external.max.dop | 外部テーブルによってアクセスされるワーカーの最大同時実行数。 | このパラメーターの値は正の整数でなければなりません。 | 外部テーブルに基づくデータのクエリと書き込み |
SQL | セッション/プロジェクト | odps.sql.unstructured.file.pattern.black.list | MaxCompute SQL が Hadoop 分散ファイルシステム (HDFS) の場所を指す外部テーブルからデータを読み取るシナリオでは、Spark によってこのディレクトリに書き込まれる際に _SUCCESS ファイルを自動的に無視できます。 これにより、このファイルが原因で MaxCompute SQL がディレクトリ内のデータを読み取れないという問題を防ぎます。 たとえば、次のコードは、セッション レベルでこの動作を指定する方法を示しています。 | 有効な値: | 外部テーブルに基づくデータクエリ |
SQL | セッション | odps.meta.exttable.stats.onlinecollect | 外部クエリのデータはデータレイクに格納されているため、オープン性を考慮してメタデータ処理をローカルで実行することはできません。さらに、データは外部に配置され、統計情報は事前に収集されていないため、クエリ オプティマイザーは保守的な戦略を採用しており、クエリの効率が低下します。オプティマイザーは、クエリ実行中にテーブルの統計情報を一時的に収集することにより、小さなテーブルを検出できます。その後、積極的にハッシュ結合を使用し、結合順序を最適化し、広範なシャッフル操作を削減し、実行パイプラインを短縮し、最終的にクエリプランを最適化します。 |
| 外部テーブルに基づくデータクエリ |
SQL | プロジェクト | odps.sql.allow.fullscan | プロジェクトで全表スキャンを有効にするかどうかを指定します。 全表スキャンは大量のリソースを消費するため、データ処理効率が低下します。 そのため、この機能を有効にしないことをお勧めします。 |
| SELECT |
SQL | プロジェクト | odps.table.lifecycle | プロジェクト内のテーブルのライフサイクルを設定するかどうかを指定します。 |
| CREATE TABLE |
SQL | プロジェクト | odps.table.lifecycle.value | テーブルのライフサイクル。単位:日。 | 有効な値:1 ~ 37231。デフォルト値:37231。 | CREATE TABLE |
SQL | プロジェクト | READ_TABLE_MAX_ROW | SELECT 文で返されるデータレコードの最大数。 | 有効な値:1 ~ 10000。デフォルト値:10000。 | SELECT |
SQL | プロジェクト | odps.output.field.formatter | SQL クエリ結果の動的データマスキングルール。MaxCompute の動的データマスキングの詳細については、「動的データマスキング」をご参照ください。 | カスタム動的データマスキングルール。 | SELECT |
SQL | プロジェクト | odps.sql.acid.table.enable | 原子性、一貫性、隔離性、耐久性 (ACID) メカニズムを有効にするかどうかを指定します。 ACID の詳細については、「ACID セマンティクス」をご参照ください。 |
| すべて |
SQL | セッション/プロジェクト | odps.io.oss.use.vipserver | Object Storage Service (OSS) へのアクセスは、外部アクセス用の VIPServer によって実行できます。この設定が有効になっていない場合、OSS へのアクセスは Server Load Balancer (SLB) を介して行われます。 VIPServer メソッドは、より高いトラフィック制限を可能にし、フロー制御の対象となりますが、クエリ障害などの特定の安定性のリスクも伴います。このオプションを使用するかどうかを決定する前に、これらのリスクを評価する必要があります。 |
| 外部テーブルに基づくデータクエリ |
SQL | セッション/プロジェクト | 日付の完全なフォーマットへの文字列の有効化 | 時、分、秒を含む日付文字列を変換するかどうかを指定します。 デフォルト値: False。 |
| CAST |
SQL | セッション/プロジェクト | odps.sql.executionengine.enable.rand.time.seed | このパラメーターを False に設定すると、RAND 関数はインスタンス ID を乱数初期化のシードとして使用します。 これにより、関数のべき等性が保証されます。 このパラメーターを True に設定すると、RAND 関数はシステム時間を乱数初期化のシードとして使用します。 この場合、RAND 関数はべき等ではなくなり、シャッフルキーとして使用できなくなります。 戻り値は RAND 関数を使用するたびに異なります。 デフォルト値:False。 |
| RAND |
SQL | セッション/プロジェクト | odps.sql.type.system.odps2 | MaxCompute V2.0 データ型エディションを有効にするかどうかを指定します。MaxCompute V2.0 データ型エディションでサポートされているデータ型については、「MaxCompute V2.0 データ型エディション」をご参照ください。 |
| MaxCompute V2.0 の追加機能 |
SQL | セッション/プロジェクト | odps.sql.type.json.enable | JSON データ型を有効にするかどうかを指定します。JSON データ型の詳細については、「MaxCompute での JSON データ型の使用手順」をご参照ください。 |
| MaxCompute JSON データ型 |
SQL | セッション/プロジェクト | odps.sql.hive.compatible | Hive 互換データ型エディションを有効にするかどうかを指定します。MaxCompute は、Hive 互換データ型エディションが有効になっている場合のみ、inputRecordReader、outputRecordReader、Serde などの Hive 構文をサポートします。Hive 互換データ型エディションでサポートされているデータ型の詳細については、「Hive 互換データ型エディション」をご参照ください。 |
| すべて |
SQL | セッション/プロジェクト | odps.sql.metering.value.max | SQL 文で消費できるリソースの上限です。 消費制御の詳細については、「消費制御」をご参照ください。 | - | すべて |
SQL | セッション/プロジェクト | odps.sql.timezone | アクセスした MaxCompute プロジェクトのタイムゾーンです。タイムゾーンの詳細については、「タイムゾーン構成操作」をご参照ください。 | - | すべて |
SQL | セッション/プロジェクト | odps.sql.unstructured.oss.commit.mode | OSS のマルチパートアップロード機能を有効にして OSS 外部テーブルにデータを書き込むかどうかを指定します。詳細については、「OSS にデータを書き込む」をご参照ください。 |
| INSERT OVERWRITE |
SQL | セッション/プロジェクト | odps.sql.groupby.orderby.position.alias | SELECT 文でGROUP BY 句と ORDER BY 句の整数定数を列番号として使用するかを指定します。 説明 既存のプロジェクトに対してこのパラメーターを True に設定すると、データ解析などの操作が実行できない場合があります。 このパラメーターを True に設定する場合は、元のロジックが既存のプロジェクトに対して正しく実行できることを確認する必要があります。 そうでない場合は、セッションに対してこのパラメーターを指定してください。 |
|
|
SQL | セッション/プロジェクト | odps.ext.oss.orc.native | テーブルからデータを読み取る際に、ネイティブの Optimized Row Columnar (ORC) リーダーを使用するかどうかを指定します。 |
| SELECT |
SQL | セッション | odps.sql.job.max.time.hours | 1 つのジョブの最大実行時間です。 | 有効な値:1~72。デフォルト値:24。 | SQL ジョブ |
課金ルール | セッション | odps.task.quota.preference.tag | 指定されたジョブに割り当てられるクォータグループ。 [MaxCompute マネージャー] でクォータグループを設定できます。 サブスクリプションリソースを使用するプロジェクトの場合、このパラメーターを設定して、ジョブで使用できるレベル 2 のクォータグループを指定できます。 ジョブは、クォータタグがジョブのクォータタグと同じクォータグループに優先的にスケジュールされます。 ジョブを送信するときは、ジョブのクォータタグを設定する必要があります。 同じクォータタグを持つクォータグループがない場合、ジョブは、ジョブが属するプロジェクトによって指定されたクォータグループにスケジュールされます。 次の文を実行して、クォータタグを設定できます。 説明 このパラメーターは、SQL ジョブでのみ使用できます。 | タグ名tag_name は、 で設定するクォータグループのクォータタグを指定します。 ジョブのプロジェクトが属するリージョン内のクォータグループに対してのみ tag_name を設定できます。 tag_name の値には、文字、数字、およびアンダースコア(_)を含めることができます。 | すべて |
請求ルール | セッション | odps.task.wlm.quota | セッションでジョブを実行するために使用されるクォータの名前です。 | - | ALL |
セキュリティと権限 | プロジェクト | odps.forbid.fetch.result.by.bearertoken | LogView の [Result] タブにジョブの結果を表示するかどうかを指定します。このパラメーターは、データセキュリティを保護するために使用されます。 |
| ALL |
セキュリティと権限 | プロジェクト | ラベルセキュリティ | LabelSecurity を有効にするかどうかを指定します。 LabelSecurity の詳細については、「ラベルベースのアクセス制御」をご参照ください。 |
| すべて |
セキュリティと権限 | プロジェクト | CheckPermissionUsingACL | ACL ベースのアクセス制御を有効にするかどうかを指定します。 ACL ベースのアクセス制御の詳細については、「MaxCompute 権限」をご参照ください。 |
| すべて |
セキュリティと権限 | プロジェクト | CheckPermissionUsingPolicy | ポリシーベースのアクセス制御を有効にするかどうかを指定します。ポリシーベースのアクセス制御の詳細については、「ポリシーベースのアクセス制御」をご参照ください。 |
| すべて |
セキュリティと権限 | プロジェクト | ObjectCreatorHasAccessPermission | オブジェクトの作成者が、自身が作成したオブジェクトに対して操作を実行できるかどうかを指定します。 |
| ALL |
セキュリティと権限 | プロジェクト | ObjectCreatorHasGrantPermission | オブジェクトの作成者が他のユーザーにオブジェクトに対する操作の実行を承認できるかどうかを指定します。 |
| ALL |
セキュリティと権限 | プロジェクト | ProjectProtection | プロジェクトデータ保護を有効にするかどうかを指定します。 プロジェクトデータ保護の詳細については、「プロジェクトデータ保護」をご参照ください。 |
| ALL |
セキュリティと権限 | プロジェクト | odps.output.field.formatter | SQL クエリ結果の動的データマスキングルール。詳細については、「動的データマスキング」をご参照ください。 | カスタム動的データマスキングルール。 | SELECT |
権限セキュリティ | プロジェクト | odps.security.ip.whitelist | クラウドプロダクト相互接続ネットワーク経由でプロジェクトにアクセスすることを承認されている IP アドレスのホワイトリスト。 IP アドレスホワイトリストの詳細については、「IP アドレスホワイトリストの管理」をご参照ください。 | IP アドレスのリスト。IP アドレスはカンマ (,) で区切ります。 | ALL |
権限セキュリティ | プロジェクト | odps.security.vpc.whitelist | 特定の VPC (仮想プライベートクラウド) 経由でプロジェクトにアクセスすることを承認されている IP アドレスのホワイトリスト。 IP アドレスのホワイトリストの詳細については、「IP アドレスホワイトリストの管理」をご参照ください。 | RegionID_VPCID[IP アドレス] | ALL |
データ型 | プロジェクト | odps.sql.decimal.odps2 | MaxCompute V2.0 データ型エディションで DECIMAL(precision,scale) を有効にするかどうかを指定します。データ型の詳細については、「MaxCompute V2.0 データ型エディション」をご参照ください。 |
| ALL |
データストレージ | プロジェクト | odps.timemachine.retention.days | 日単位でのバックアップデータの保存期間。 データバックアップの詳細については、「バックアップ」をご参照ください。 | 有効な値: 0 ~ 30 。デフォルト値: 1 。 | すべて |
メタデータ | プロジェクト | odps.schema.evolution.enable | スキーマ進化を有効にするかどうかを指定します。 |
| スキーマ進化 |
クエリフラグパラメーター値
プロジェクトレベルまたはセッションレベルでフラグパラメーターの値をクエリできます。
プロジェクトレベル: プロジェクトのすべてのフラグパラメーターの値をクエリするには、MaxCompute クライアント (odpscmd) で
setproject;コマンドを実行します。セッションレベル: セッションのフラグパラメーターの値をクエリするには、LogView を使用します。