このトピックでは、フラグパラメーターを一覧表示します。パラメーターを検索して、その範囲、プロパティ名、説明を確認できます。
カテゴリ | 影響範囲 | プロパティ名 | 説明 | 有効値 | 影響を受ける 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 ステージのワーカー数を間接的に制御します。 説明
| 単位: 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 関数が値を返すときに元の文字列を保持するかどうかを指定します。 説明 GET_JSON_OBJECT 関数の詳細については、「文字列関数」をご参照ください。
|
| UDF |
SQL | セッション | odps.sql.udf.jvm.memory | UDF の JVM ヒープの最大メモリ。 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 パッケージを指定できます。カンマ (,) で区切ります。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 機能を有効にするかどうかを指定します。Freeride 機能を有効にすると、テーブルの列統計が自動的に収集されます。オプティマイザー情報の収集方法の詳細については、オプティマイザーをご参照ください。 |
|
|
SQL | セッション | odps.optimizer.stat.collect.plan | 指定された列の指定された列統計メトリックを収集するために使用される収集計画。オプティマイザー情報の収集方法の詳細については、オプティマイザーをご参照ください。 | - |
|
SQL | セッション | odps.sql.external.net.vpc | 外部テーブルの VPC サポートを有効にするかどうかを指定します。詳細については、Hologres 外部テーブルをご参照ください。 |
| CREATE TABLE |
SQL | セッション | odps.sql.groupby.position.alias | groupby 句の整数定数を SELECT 文の列の序数として使用するかどうかを指定します。 |
|
|
SQL | セッション | odps.sql.groupby.skewindata | groupby 句の傾き防止メカニズムを有効にするかどうかを指定します。 |
| GROUP BY |
SQL | セッション | odps.sql.orderby.position.alias | orderby 句の整数定数を SELECT 文の列の序数として使用するかどうかを指定します。 |
|
|
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 | JOIN |
SQL | セッション | odps.sql.python.version | SQL 文を実行するための Python バージョン。 |
|
|
SQL | セッション | ODPS SQL SELECT の出力フォーマット | MaxCompute クライアントによって返される結果にテーブルヘッダーを表示するかどうかを指定します。MaxCompute クライアントの使用方法の詳細については、クライアント (odpscmd) を使用した MaxCompute への接続をご参照ください。 |
| すべて |
SQL | セッション | odps.sql.unstructured.data.oss.use.https | 外部テーブルにアクセスする際に、基盤となるレイヤーで HTTPS 経由でデータを取得するメカニズムを有効にするかどうかを指定します。OSS 外部テーブルの詳細については、ORC 外部テーブルをご参照ください。 |
| すべて |
SQL | セッション | odps.sql.decimal.tostring.trimzero | DECIMAL 型のデータについて、小数点以下の末尾のゼロを削除するかどうかを指定します。デフォルト値は |
| キャスト |
SQL | セッション | odps.sql.unstructured.tablestore.put.row | PutRow を使用して Tablestore 外部テーブルにデータを書き込むことをサポートするかどうかを指定します。 説明 PutRow の詳細については、「PutRow」をご参照ください。 |
| すべて |
SQL | セッション | odps.sql.unstructured.external.max.dop | 外部テーブルにアクセスするワーカーの最大並列度。 | 正の整数。 | 外部テーブルのクエリと書き込み |
SQL | セッション/プロジェクト | odps.sql.unstructured.file.pattern.black.list | MaxCompute SQL が OSS または HDFS の場所を指す外部テーブルからデータを読み取る際、このパラメーターは自動的に | 値: | 外部テーブルのクエリ |
SQL | セッション | odps.meta.exttable.stats.onlinecollect | 外部クエリからのデータはデータレイクに保存されるため、データレイクのオープンな性質上、ローカルメタデータを処理できません。さらに、データが外部にあり、統計が事前に収集されていないため、実行計画を生成する際には保守的な戦略が採用されることが多く、実行効率が低くなります。 この機能により、オプティマイザーはクエリ実行中に一時的にテーブルの統計情報を収集して小規模テーブルを検出し、プロアクティブにハッシュ結合を使用し、結合順序を最適化し、大量のシャッフルを削減し、実行パイプラインを短縮してクエリ計画を最適化できます。 | 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 セマンティクスをご参照ください。 |
| すべて |
SQL | セッション/プロジェクト | odps.io.oss.use.vipserver | 外部テーブルの OSS にアクセスするために仮想 IP アドレス (VIP) サーバーを使用するかどうかを指定します。このパラメーターが無効になっている場合、SLB が使用されます。VIP サーバーはより高いトラフィック制限を提供し、速度制限をサポートします。ただし、クエリの失敗などの安定性のリスクがあります。このパラメーターを有効にする前に、リスクを評価してください。 |
| 外部テーブルのクエリ |
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 | MaxCompute V2.0 データ型エディションを有効にするかどうかを指定します。MaxCompute V2.0 データ型の詳細については、データ型 (バージョン 2.0) をご参照ください。 |
| MaxCompute V2.0 拡張関数 |
SQL | セッション/プロジェクト | odps.sql.type.json.enable | JSON データ型を有効にするかどうかを指定します。JSON データ型の詳細については、JSON データ型をご参照ください。 |
| MaxCompute JSON データ型 |
SQL | セッション/プロジェクト | odps.sql.hive.compatible | Hive 互換モードを有効にするかどうかを指定します。Hive 互換モードを有効にすると、MaxCompute は inputRecordReader、outputRecordReader、Serde など、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 | 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 | ジョブのクォータグループを指定します。クォータグループは、MaxCompute マネージャーのクォータグループです。サブスクリプションリソースを使用するプロジェクトの場合、このプロパティを使用してジョブのセカンダリクォータグループを指定できます。ジョブの送信時に設定されたクォータタグがクォータグループプロパティのクォータタグと同じである場合、ジョブはこのクォータグループに優先的にスケジュールされます。それ以外の場合、ジョブはジョブが属するプロジェクトに指定されたクォータグループにスケジュールされます。 次の文を実行してパラメーターを設定します。 説明 このプロパティは SQL ジョブでのみサポートされます。 | tag_name は、MaxCompute マネージャーのクォータグループのクォータグループタグです。クォータグループは、ジョブが属するプロジェクトのオーナーがいるリージョンのクォータグループのみです。tag_name には、文字、数字、アンダースコア (_) のみを含めることができます。 | すべて |
課金 | セッション | odps.task.wlm.quota | 指定されたリソースは、現在のセッションのタスクを実行するために使用されます。値は対応する QuotaName です。 | - | ALL |
セキュリティと権限 | プロジェクト | odps.forbid.fetch.result.by.bearertoken | Logview が [結果] タブにジョブの実行結果を表示することを禁止するかどうかを指定します。このパラメーターは、主にデータセキュリティを保護するために使用されます。 |
| 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 | DECIMAL 2.0 データ型の DECIMAL(precision,scale) を有効にするかどうかを指定します。データ型の詳細については、データ型 (バージョン 2.0) をご参照ください。 |
| ALL |
データストレージ | プロジェクト | odps.timemachine.retention.days | バックアップデータの保持期間。データバックアップの詳細については、ローカルバックアップをご参照ください。 | 範囲:0~30。デフォルト値:1。 | すべて |
メタデータ | プロジェクト | odps.schema.evolution.enable | スキーマ進化機能を有効にします。 |
| スキーマ進化。 |
クエリフラグパラメーター値
プロジェクトレベルまたはセッションレベルでフラグパラメーターの値をクエリできます。
プロジェクトレベル:MaxCompute クライアント (odpscmd) で、
setproject;コマンドを実行して、プロジェクト内のすべてのフラグパラメーター値をクエリします。セッションレベル:Logview でセッションのパラメーター値を確認します。