このトピックでは、MaxCompute のフラグ パラメーターを一覧で示します。ページ内を検索すると、各パラメーターのスコープ、プロパティ名、説明を確認できます。
カテゴリ | スコープ | パラメーター | 説明 | 値 | 影響を受けるコマンド |
エコシステム | セッション | console.sql.result.instancetunnel | InstanceTunnel を有効または無効にします。Tunnel コマンドの詳細については、「使用手順」をご参照ください。 |
| SELECT |
スケジューリング | セッション | odps.job.workers.limit | ジョブ全体の最大ワーカー同時実行数を指定します。 | 範囲: 1~1000000 | ALL |
スケジューリング | セッション | 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 ステージのワーカー数を間接的に制御します。 説明
| 単位: 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 | 各 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 文で | 1~10000 | ALL |
スケジューリング | プロジェクト | odps.instance.priority.enable | サブスクリプションリソースを使用するプロジェクトのジョブ優先度を有効または無効にします。ジョブ優先度機能の詳細については、「ジョブ優先度」をご参照ください。 |
説明 この機能を有効にできるのは、プロジェクトオーナーまたは Super_Administrator ロールを持つユーザーのみです。 | 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 | プロジェクト | odps.output.field.formatter | SQL クエリ結果の動的データマスキングルールを設定します。MaxCompute の動的データマスキングの詳細については、「動的データマスキング」をご参照ください。 | カスタム動的データマスキングルール。 | 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 の [Result] タブでジョブ結果の表示を禁止するかどうかを指定します。このプロパティを使用してデータを保護できます。 |
| ALL |
セキュリティ | プロジェクト | LabelSecurity | LabelSecurity メカニズムを有効にするかどうかを指定します。LabelSecurity メカニズムの詳細については、「ラベルベースのアクセス制御」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | CheckPermissionUsingACL | アクセスコントロールリスト (ACL) 認可メカニズムを有効にするかどうかを指定します。ACL ベースの認可の詳細については、「MaxCompute の権限」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | CheckPermissionUsingPolicy | ポリシーベースの認可メカニズムを有効にするかどうかを指定します。ポリシーベースの認可の詳細については、「ポリシーベースのアクセス制御」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | ObjectCreatorHasAccessPermission | オブジェクト作成者がデフォルトでオブジェクトへのアクセス権限を持つかどうかを指定します。 |
| ALL |
セキュリティ | プロジェクト | ObjectCreatorHasGrantPermission | オブジェクト作成者がデフォルトでオブジェクトへの権限付与権限を持つかどうかを指定します。 |
| ALL |
セキュリティ | プロジェクト | ProjectProtection | データ保護メカニズムを有効にするかどうかを指定します。データ保護メカニズムの詳細については、「データ保護メカニズム」をご参照ください。 |
| ALL |
セキュリティ | プロジェクト | odps.output.field.formatter | SQL クエリ結果の動的データマスキングルールを設定します。MaxCompute の動的データマスキングの詳細については、「動的データマスキング」をご参照ください。 | カスタム動的データマスキングルール。 | SELECT |
セキュリティ | プロジェクト | odps.security.ip.whitelist | パブリックインターネット経由でプロジェクトにアクセスするクライアントの IP ホワイトリストを設定します。これは通常、クラウドサービスの統合に使用されます。IP ホワイトリストの詳細については、「IP ホワイトリストの管理」をご参照ください。 | IP アドレスのリスト (カンマ (,) 区切り)。 | ALL |
セキュリティ | プロジェクト | odps.security.vpc.whitelist | VPC からプロジェクトにアクセスするための IP ホワイトリストを指定します。IP ホワイトリストの詳細については、「IP ホワイトリストの管理」をご参照ください。 | 形式: RegionID_VPCID[IP アドレス] | 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) で
setproject;を実行すると、プロジェクトのすべてのフラグパラメーターが一覧表示されます。セッションレベル: Logview でセッションレベルのパラメーターを表示します。