このトピックでは、MaxCompute のフラグパラメーターを一覧で紹介します。このページ内を検索することで、パラメーターのスコープ、プロパティ名、説明を確認できます。
カテゴリ | スコープ | パラメーター | 説明 | 値 | 対象コマンド |
エコシステム | セッション | console.sql.result.instancetunnel | InstanceTunnel を有効または無効にします。Tunnel コマンドの詳細については、「使用方法」をご参照ください。 |
| SELECT |
スケジューリング | セッション | odps.job.workers.limit | ジョブ全体のワーカーの最大同時実行数を設定します。 | 範囲:1~1000000 | ALL |
スケジューリング | セッション | odps.stage.mapper.mem | 各マップワーカーのメモリサイズを設定します。 | 範囲:256 MiB~12288 MiB。デフォルト値:1024 MiB。 | ALL |
スケジューリング | セッション | odps.stage.reducer.mem | 各リデュースワーカーのメモリサイズを設定します。 | 範囲:256 MiB~12288 MiB。デフォルト値:1024 MiB。 | ALL |
スケジューリング | セッション | odps.stage.joiner.mem | 各ジョインワーカーのメモリサイズを設定します。 | 範囲: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 | 各マップワーカーの入力データサイズを設定します。これは、入力ファイルのスプリットサイズに対応します。これにより、各マップステージのワーカー数が間接的に制御されます。 説明
| 単位:MiB。デフォルト値:256 MiB。 | ALL |
スケジューリング | セッション | odps.sql.split.size | テーブルレベルの並列処理のための単一データスプリットのサイズを設定します。 | 単位:MiB。 例: | ALL |
スケジューリング | セッション | odps.sql.split.row.count | テーブルレベルの並列処理のための単一スプリット内の行数を設定します。 説明 内部の非トランザクションテーブルおよび非クラスター化テーブルにのみ適用されます。 | 0 より大きい整数。 例: | ALL |
スケジューリング | セッション | odps.sql.split.dop | テーブルレベルの並列度を設定します。 説明 内部の非トランザクションテーブルおよび非クラスター化テーブルにのみ適用されます。 | 0 より大きい整数。 例: | ALL |
スケジューリング | セッション | odps.stage.reducer.num | 各リデュースステージのワーカー数を設定します。 説明 この設定を構成する場合、SQL 文で | - | ALL |
スケジューリング | セッション | odps.stage.joiner.num | 各ジョインステージのワーカー数を設定します。 説明 この項目を構成する場合、SQL 文で | - | ALL |
スケジューリング | セッション | odps.stage.num | MaxCompute ジョブのステージごとの同時実行数 (ワーカー数) を設定します。このプロパティは、odps.stage.mapper.split.size、odps.stage.reducer.num、およびodps.stage.joiner.num よりも優先度が低くなります。 説明 この設定を構成する場合、SQL 文で | 1~10000 | ALL |
スケジューリング | プロジェクト | odps.instance.priority.enable | サブスクリプションリソースを使用するプロジェクトのジョブ優先度を有効または無効にします。ジョブ優先度機能の詳細については、「ジョブ優先度」をご参照ください。 |
説明 プロジェクト所有者または | ALL |
SQL | セッション | odps.sql.reshuffle.dynamicpt | 多数の小さいファイルが作成されるのを防ぐために、動的パーティションのリシャッフルを有効または無効にします。 |
説明 生成される動的パーティションが少ない場合は、データスキューを防ぐためにこのプロパティを False に設定します。 |
|
SQL | セッション | odps.sql.udf.getjsonobj.new | GET_JSON_OBJECT 関数が特殊文字をエスケープせずに元の文字列を返すかどうかを指定します。 説明 GET_JSON_OBJECT 関数の詳細については、「文字列関数概要」をご参照ください。
|
| UDF |
SQL | セッション | odps.sql.udf.jvm.memory | UDF がインメモリコンピューティングやソートのために大量のデータを処理する場合、メモリ不足 (OOM) エラーが発生する可能性があります。この場合、このプロパティの値を増やすことができます。ただし、これは一時的な解決策であり、UDF コードを最適化することが長期的な解決策として推奨されます。 | 範囲:256 MiB~12288 MiB。デフォルト値:1024 MiB。 | UDF |
SQL | セッション | odps.function.timeout | UDF のタイムアウト時間を設定します。 | 範囲:0 秒~3600 秒。デフォルト値:600 秒。 | UDF |
SQL | セッション | odps.sql.session.resources | UDT によって参照されるリソースを指定します。複数のリソースをコンマ (,) で区切って指定できます。 参照されるリソースの詳細については、「UDT 概要」をご参照ください。 | アップロードされたリソース。 | UDT |
SQL | セッション | odps.sql.udt.display.tostring | 最終的な出力型が UDT であるすべての列を java.util.Objects.toString(...) でラップするかどうかを指定します。 |
| UDT |
SQL | セッション | odps.sql.session.java.imports | UDT によって参照される Java パッケージを指定します。複数のパッケージをコンマ (,) で区切って指定できます。Java パッケージの詳細については、「UDT 概要」をご参照ください。 | アップロードされた 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 | パーティションプルーニング情報をバックフィルできない場合にエラーを無視するかどうかを指定します。パーティションプルーニングの詳細については、「WHERE 句 (WHERE_condition)」をご参照ください。 |
| UDF |
SQL | セッション | odps.optimizer.enable.range.partial.repartitioning | 範囲クラスター化テーブルのシャッフル削除メカニズムを有効にするかどうかを指定します。 |
|
|
SQL | セッション | odps.optimizer.merge.partitioned.table | クエリが同じパーティションテーブルを繰り返し使用する場合、このプロパティを有効にしてパーティションをマージします。これにより、テーブルに対する I/O が最小限に抑えられ、パフォーマンスが向上します。 |
| SELECT |
SQL | セッション | odps.optimizer.skew.join.topk.num | オプティマイザが集計操作を実行するときに収集するホットキーの数を設定します。詳細については、「SKEWJOIN HINT」をご参照ください。 | - | SKEWJOIN HINT |
SQL | セッション | odps.optimizer.stat.collect.auto | テーブルの列統計を自動的に収集する Freeride 機能を有効にするかどうかを指定します。オプティマイザの統計収集の詳細については、「オプティマイザ」をご参照ください。 |
|
|
SQL | セッション | odps.optimizer.stat.collect.plan | 特定の列の統計を収集するための収集計画を指定します。オプティマイザの統計収集の詳細については、「オプティマイザ」をご参照ください。 | - |
|
SQL | セッション | odps.sql.external.net.vpc | 外部テーブルの VPC サポートを有効にするかどうかを指定します。詳細については、「Hologres 外部テーブル」をご参照ください。 |
| CREATE TABLE |
SQL | セッション | odps.sql.groupby.position.alias | GROUP BY 句の整数定数を SELECT リストの列序数として扱うかどうかを指定します。 |
|
|
SQL | セッション | odps.sql.groupby.skewindata | GROUP BY 操作のアンチスキューメカニズムを有効にするかどうかを指定します。 |
| GROUP BY |
SQL | セッション | odps.sql.orderby.position.alias | ORDER BY 句の整数定数を SELECT リストの列序数として扱うかどうかを指定します。 |
|
|
SQL | セッション | odps.sql.mapjoin.memory.max | MAPJOIN 操作中にメモリにロードされる小さいテーブルのメモリサイズを設定します。単位:MiB。 説明 このパラメーターは、タスクレベルのグローバル合計メモリ制限の制約も受けます。同一タスク内の複数の小さいテーブルの合計メモリに対するグローバルな上限は | 値の範囲:0 MiB~8192 MiB | JOIN |
SQL | セッション | odps.sql.distributed.map.join.memory.max | MAPJOIN 操作中の各 HashTableBuilder インスタンスのメモリサイズを設定します。デフォルト値は 2048 です。単位:MiB。 | 範囲:0 MiB~8192 MiB | JOIN |
SQL | セッション | odps.sql.python.version | SQL 文の実行に使用する Python のバージョンを設定します。 |
|
|
SQL | セッション | odps.sql.select.output.format | MaxCompute クライアントで結果にヘッダー行を表示するかどうかを指定します。MaxCompute クライアントの使用方法の詳細については、「クライアント (odpscmd) を使用した接続」をご参照ください。 |
| ALL |
SQL | セッション | odps.sql.unstructured.data.oss.use.https | 外部テーブルにアクセスする際に HTTPS 経由でデータを取得するかどうかを指定します。OSS 外部テーブルの詳細については、「ORC 外部テーブル」をご参照ください。 |
| ALL |
SQL | セッション | odps.sql.decimal.tostring.trimzero | Decimal データ型の小数点以下の末尾のゼロを削除するかどうかを指定します。デフォルト値は |
| CAST |
SQL | セッション | odps.sql.unstructured.tablestore.put.row | Tablestore 外部テーブルへのデータ書き込みに、PutRow 書き込みモードを使用するかどうかを指定します。 説明 PutRow の詳細については、「PutRow」をご参照ください。 |
| ALL |
SQL | セッション | odps.sql.unstructured.external.max.dop | 外部テーブルにアクセスするワーカーの最大同時実行数を設定します。 | 0 より大きい整数。 | 外部テーブルのクエリと書き込み |
SQL | セッション/プロジェクト | odps.sql.unstructured.file.pattern.black.list | MaxCompute SQL が OSS または HDFS の場所から外部テーブルを読み取るときに、Spark によって書き込まれた |
| 外部テーブルクエリ |
SQL | セッション | odps.meta.exttable.stats.onlinecollect | 外部テーブルのデータはデータレイクに存在します。これらはオープンであるため、MaxCompute はメタデータをローカルで管理できません。統計がないと、オプティマイザは多くの場合、保守的な実行計画を生成し、パフォーマンスが低下します。 この機能を有効にすると、オプティマイザはクエリ実行中にテーブル統計を収集して小さいテーブルを特定できます。これにより、オプティマイザはハッシュ結合、結合順序の最適化、シャッフルの削減、実行パイプラインの短縮などの手法を使用してクエリ計画を改善できます。 | True:有効。 False (デフォルト値): 無効。 | 外部テーブルクエリ |
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 | Project | odps.output.field.formatter | Sets dynamic data masking rules for SQL query results. For more information about dynamic data masking in MaxCompute, see Dynamic data masking. | Custom dynamic data masking rules. | SELECT |
SQL | プロジェクト | odps.sql.acid.table.enable | ACID メカニズムを有効にするかどうかを指定します。ACID の詳細については、「ACID セマンティクス」をご参照ください。 |
| ALL |
SQL | セッション/プロジェクト | odps.io.oss.use.vipserver | 外部テーブルの OSS へのアクセスに VIPServer を使用するかどうかを指定します。このプロパティが有効でない場合、SLB が使用されます。VIPServer はより高いトラフィック制限を提供し、トラフィック制御をサポートしますが、クエリの失敗といった安定性に関するリスクも伴います。このプロパティを有効にする前に、これらのリスクを評価してください。 |
| 外部テーブルクエリ |
SQL | セッション/プロジェクト | odps.sql.executionengine.enable.string.to.date.full.format | 時、分、秒を含む日付文字列を変換するには、このプロパティを True に設定します。デフォルト値は False です。 |
| CAST |
SQL | セッション/プロジェクト | odps.sql.executionengine.enable.rand.time.seed | このプロパティが False に設定されている場合、Rand 関数は現在のインスタンス ID をシードとして使用して乱数を初期化します。これにより、関数のべき等性が保証されます。 このプロパティが True に設定されている場合、Rand 関数は現在のシステム時刻をシードとして使用します。この場合、Rand 関数はべき等ではなく、シャッフルキーとして使用できません。ジョブを再実行すると、異なる結果が生成されます。 デフォルト値は False です。 |
| RAND |
SQL | セッション/プロジェクト | odps.sql.type.system.odps2 | データ型 2.0 を有効または無効にします。データ型 2.0 の詳細については、「データ型バージョン 2.0」をご参照ください。 |
| MaxCompute 2.0 拡張関数 |
SQL | セッション/プロジェクト | odps.sql.type.json.enable | JSON データ型を有効または無効にします。JSON データ型の詳細については、「JSON データ型」をご参照ください。 |
| MaxCompute JSON データ型 |
SQL | セッション/プロジェクト | odps.sql.hive.compatible | Hive 互換モードを有効または無効にします。有効にすると、MaxCompute は inputRecordReader、outputRecordReader、Serde など、さまざまな Hive 固有の構文をサポートします。互換性のあるデータ型の詳細については、「Hive 互換のデータ型バージョン」をご参照ください。 |
| ALL |
SQL | セッション/プロジェクト | odps.sql.metering.value.max | 単一の SQL クエリの消費制限を設定します。消費監視の詳細については、「消費監視、アラート、および制御」をご参照ください。 | - | ALL |
SQL | セッション/プロジェクト | odps.sql.timezone | MaxCompute プロジェクトのタイムゾーンを設定します。タイムゾーンの詳細については、「タイムゾーン設定操作」をご参照ください。 | - | ALL |
SQL | セッション/プロジェクト | odps.sql.unstructured.oss.commit.mode | OSS 外部テーブルへのデータ書き込みで、マルチパートアップロードを有効にするかどうかを指定します。詳細については、「OSS へのデータの書き込み」をご参照ください。 |
| INSERT OVERWRITE |
SQL | セッション/プロジェクト | odps.sql.groupby.orderby.position.alias | GROUP BY および ORDER BY 句の整数定数を SELECT リストの列序数として扱うかどうかを指定します。 説明 既存のプロジェクトの場合、プロジェクトレベルでこのプロパティを有効にすると、既存のジョブに影響を及ぼす可能性があります。このプロパティを変更する前に、既存のジョブが正しく実行されることを確認してください。そうでない場合は、セッションレベルでこのプロパティを設定してください。 |
|
|
SQL | セッション/プロジェクト | odps.ext.oss.orc.native | ネイティブ ORC リーダーを使用してテーブルを読み取るかどうかを指定します。 |
| SELECT |
SQL | セッション/プロジェクト | odps.sql.job.max.time.hours | 単一ジョブの最大実行時間を設定します。 | 範囲:1~72。デフォルト値:24。 | SQL ジョブ |
課金 | セッション | odps.task.quota.preference.tag | サブスクリプションリソースを使用するプロジェクトでは、このプロパティはジョブを特定のセカンダリクォータグループに割り当てます。ジョブのクォータタグがクォータグループのタグと一致する場合、ジョブはそのグループに優先的にスケジューリングされます。それ以外の場合、ジョブはプロジェクトのデフォルトクォータグループにスケジューリングされます。 次のステートメントを実行して、プロパティを設定します。 説明 このプロパティは SQL ジョブにのみ適用されます。 | tag_name は、MaxCompute Housekeeper のクォータグループのタグです。 クォータグループは、ジョブが属するプロジェクトの所有者と同じリージョンにある必要があります。 tag_name には、英字、数字、およびアンダースコア (_) のみを含めることができます。 | ALL |
課金 | セッション | odps.task.wlm.quota | 現在のセッションでタスクの実行に使用するクォータグループを、名前で指定します。 | - | ALL |
セキュリティ | プロジェクト | odps.forbid.fetch.result.by.bearertoken | Logview の [結果] タブでジョブ結果の表示を禁止するかどうかを指定します。このプロパティは、データの保護に使用できます。 |
| ALL |
セキュリティ | プロジェクト | LabelSecurity | LabelSecurity メカニズムを有効にするかどうかを指定します。LabelSecurity メカニズムの詳細については、「ラベルベースのアクセス制御」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | CheckPermissionUsingACL | アクセス制御リスト (ACL) 認可メカニズムを有効にするかどうかを指定します。ACL に基づく認可の詳細については、「MaxCompute の権限」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | CheckPermissionUsingPolicy | ポリシーに基づく認可メカニズムを有効にするかどうかを指定します。ポリシーに基づく認可の詳細については、「ポリシーベースのアクセス制御」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | ObjectCreatorHasAccessPermission | オブジェクト作成者がデフォルトでオブジェクトに対するアクセス権を持つかどうかを指定します。 |
| ALL |
セキュリティ | プロジェクト | ObjectCreatorHasGrantPermission | オブジェクト作成者がデフォルトでオブジェクトに対する付与権限を持つかどうかを指定します。 |
| ALL |
セキュリティ | プロジェクト | ProjectProtection | データ保護メカニズムを有効にするかどうかを指定します。データ保護メカニズムの詳細については、「データ保護メカニズム」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | odps.output.field.formatter | SQL クエリ結果の動的データマスキングルールを設定します。動的データマスキングの詳細については、「動的データマスキング」をご参照ください。 | カスタム動的データマスキングルール。 | SELECT |
セキュリティ | プロジェクト | odps.security.ip.whitelist | パブリックインターネット経由でプロジェクトにアクセスするクライアントの IP ホワイトリストを設定します。これは通常、クラウドサービス統合に使用されます。IP ホワイトリストの詳細については、「IP ホワイトリストの管理」をご参照ください。 | IP アドレスのリスト。コンマ (,) で区切ります。 | ALL |
セキュリティ | プロジェクト | odps.security.vpc.whitelist | VPC からプロジェクトにアクセスするための IP ホワイトリストを指定します。IP ホワイトリストの詳細については、「IP ホワイトリストの管理」をご参照ください。 | フォーマット:RegionID_VPCID[IP Address] | ALL |
データ型 | プロジェクト | odps.sql.decimal.odps2 | データ型 2.0 の DECIMAL(precision, scale) データ型を有効または無効にします。データ型の詳細については、「データ型バージョン 2.0」をご参照ください。 |
| ALL |
データストレージ | プロジェクト | odps.timemachine.retention.days | バックアップデータの保持期間を設定します。データバックアップの詳細については、「ローカルバックアップ」をご参照ください。 | 範囲 (日数): 0~30。デフォルト値: 1。 | ALL |
メタデータ | プロジェクト | odps.schema.evolution.enable | スキーマエボリューションを有効にするかどうかを指定します。 |
| スキーマエボリューション。 |
フラグパラメーターのクエリ
フラグパラメーターは、プロジェクトレベルまたはセッションレベルでクエリできます。
プロジェクトレベル:MaxCompute クライアント (odpscmd) で
set project;を実行して、プロジェクトのすべてのフラグパラメーターを一覧表示します。セッションレベル:Logview でセッションレベルのパラメーターを表示します。