本トピックでは、MaxCompute のフラグパラメーターの一覧を示します。このページを検索して、各パラメーターの範囲、プロパティ名、および説明を確認してください。
カテゴリ | 範囲 | パラメーター | 説明 | 値 | 影響を受けるコマンド |
エコシステム | セッション | console.sql.result.instancetunnel | InstanceTunnel の有効化または無効化を行います。トンネルコマンドの詳細については、「使用手順」をご参照ください。 |
| SELECT |
スケジュール | セッション | 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 ステートメントで | - | 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 | 単一ジョブの最大実行時間を設定します。 説明 本プロパティをプロジェクトレベルで設定するには、DingTalk 開発者コミュニティ(グループ ID:11782920)に参加するか、アプリケーションリンク を使用して MaxCompute テクニカルサポートにお問い合わせください。 | 有効値範囲: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 クエリ結果に対する動的データマスキングルールを設定します。動的データマスキングの詳細については、「動的データマスキング」をご参照ください。 | カスタム動的データマスキングルール。 | 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 でセッションレベルのパラメーターを表示します。