Topik ini mencantumkan parameter flag untuk MaxCompute, mencakup cakupan, nama properti, dan deskripsi masing-masing parameter.
Kategori | Cakupan | Parameter | Deskripsi | Nilai | Perintah yang terpengaruh |
Ekosistem | Session | console.sql.result.instancetunnel | Mengaktifkan atau menonaktifkan InstanceTunnel. Untuk informasi selengkapnya tentang perintah Tunnel, lihat Petunjuk penggunaan. |
| SELECT |
Penjadwalan | Session | odps.job.workers.limit | Jumlah maksimum worker konkuren untuk seluruh job. | Rentang: 1–1.000.000 | ALL |
Penjadwalan | Session | odps.stage.mapper.mem | Mengatur ukuran memori untuk setiap map worker. | Rentang: 256 MiB hingga 12.288 MiB. Default: 1.024 MiB. | ALL |
Penjadwalan | Session | odps.stage.reducer.mem | Mengatur ukuran memori untuk setiap reduce worker. | Rentang: 256 MiB hingga 12.288 MiB. Default: 1.024 MiB. | ALL |
Penjadwalan | Session | odps.stage.joiner.mem | Mengatur ukuran memori untuk setiap join worker. | Rentang: 256 MiB hingga 12.288 MiB. Default: 1.024 MiB. | ALL |
Penjadwalan | Session | odps.stage.mem | Mengatur ukuran memori untuk semua worker dalam task MaxCompute tertentu. Properti ini memiliki prioritas lebih rendah daripada odps.stage.mapper.mem, odps.stage.reducer.mem, dan odps.stage.joiner.mem. | Rentang: 256 MiB hingga 12.288 MiB. Tidak ada nilai default. | ALL |
Penjadwalan | Session | odps.stage.mapper.split.size | Mengatur ukuran data masukan untuk setiap map worker, yang sesuai dengan ukuran split file masukan. Hal ini secara tidak langsung mengontrol jumlah worker di setiap map stage. Catatan
| Satuan: MiB. Default: 256 MiB. | ALL |
Penjadwalan | Session | odps.sql.split.size | Mengatur ukuran satu data split untuk Pemrosesan paralel tingkat tabel. | Satuan: MiB. Contoh: | ALL |
Penjadwalan | Session | odps.sql.split.row.count | Mengatur jumlah baris dalam satu split untuk Pemrosesan paralel tingkat tabel. Catatan Hanya berlaku untuk tabel internal, non-transaksional, dan non-clustered. | Bilangan bulat lebih besar dari 0. Contoh: | ALL |
Penjadwalan | Session | odps.sql.split.dop | Mengatur paralelisme tingkat tabel. Catatan Hanya berlaku untuk tabel internal, non-transaksional, dan non-clustered. | Bilangan bulat lebih besar dari 0. Contoh: | ALL |
Penjadwalan | Session | odps.stage.reducer.num | Mengatur jumlah worker untuk setiap reduce stage. Catatan Saat Anda mengonfigurasi pengaturan ini, hindari penggunaan | - | ALL |
Penjadwalan | Session | odps.stage.joiner.num | Mengatur jumlah worker untuk setiap join stage. Catatan Saat mengonfigurasi item ini, hindari penggunaan | - | ALL |
Penjadwalan | Session | odps.stage.num | Mengatur konkurensi (jumlah worker) per stage dalam job MaxCompute. Properti ini memiliki prioritas lebih rendah daripada odps.stage.mapper.split.size, odps.stage.reducer.num, dan odps.stage.joiner.num. Catatan Saat Anda mengonfigurasi pengaturan ini, sebaiknya hindari penggunaan | 1–10.000 | ALL |
Penjadwalan | Proyek | odps.instance.priority.enable | Mengaktifkan atau menonaktifkan prioritas job untuk proyek yang menggunakan resource subscription. Untuk informasi selengkapnya tentang fitur prioritas job, lihat Prioritas Job. |
Catatan Hanya pemilik proyek atau pengguna yang memiliki role Super_Administrator yang dapat mengaktifkan fitur ini. | ALL |
SQL | Session | odps.sql.reshuffle.dynamicpt | Mengaktifkan atau menonaktifkan reshuffling untuk partisi dinamis guna mencegah pembuatan terlalu banyak file kecil. |
Catatan Jika hanya sedikit partisi dinamis yang dihasilkan, atur properti ini ke False untuk mencegah kesenjangan data. |
|
SQL | Session | odps.sql.udf.getjsonobj.new | Menentukan apakah fungsi GET_JSON_OBJECT mengembalikan string asli tanpa melakukan escape karakter khusus. Catatan Untuk informasi selengkapnya tentang fungsi GET_JSON_OBJECT, lihat Ikhtisar Fungsi String.
|
| UDF |
SQL | Session | odps.sql.udf.jvm.memory | Error kehabisan memori (OOM) dapat terjadi jika UDF memproses data dalam jumlah besar untuk komputasi atau pengurutan dalam memori. Jika hal ini terjadi, Anda dapat meningkatkan nilai properti ini. Namun, ini hanyalah solusi sementara, dan mengoptimalkan kode UDF merupakan perbaikan jangka panjang yang disarankan. | Rentang: 256 MiB hingga 12.288 MiB. Default: 1.024 MiB. | UDF |
SQL | Session | odps.function.timeout | Mengatur durasi timeout untuk UDF. | Rentang: 0 dtk hingga 3.600 dtk. Default: 600 dtk. | UDF |
SQL | Session | odps.sql.session.resources | Menentukan resource yang direferensikan oleh UDT. Anda dapat menentukan beberapa resource, dipisahkan dengan koma (,). Untuk informasi selengkapnya tentang resource yang direferensikan, lihat Ikhtisar UDT. | Resource yang diunggah. | UDT |
SQL | Session | odps.sql.udt.display.tostring | Menentukan apakah akan membungkus semua kolom yang tipe output akhirnya adalah UDT dengan java.util.Objects.toString(...). |
| UDT |
SQL | Session | odps.sql.session.java.imports | Menentukan paket Java yang direferensikan oleh UDT. Anda dapat menentukan beberapa paket, dipisahkan dengan koma (,). Untuk informasi selengkapnya tentang paket Java, lihat Ikhtisar UDT. | Paket Java yang diunggah. | UDT |
SQL | Session | odps.sql.skewjoin | Mengaktifkan atau menonaktifkan fitur SKEWJOIN untuk mengurangi kesenjangan data. |
|
|
SQL | Session | odps.sql.skewinfo | Menentukan kunci yang mengalami skew dan nilai yang sesuai untuk operasi SKEWJOIN. Untuk informasi selengkapnya, lihat Mengoptimalkan kesenjangan data. | - |
|
SQL | Session | odps.sql.udf.ppr.deterministic | Menentukan apakah akan mengaktifkan Pemangkasan partisi dalam UDF. Untuk informasi selengkapnya tentang Pemangkasan partisi, lihat Klausa WHERE (WHERE_condition). |
| UDF |
SQL | Session | odps.sql.udf.ppr.to.subquery | Menentukan apakah akan mengabaikan error saat informasi Pemangkasan partisi tidak dapat diisi kembali. Untuk informasi selengkapnya tentang Pemangkasan partisi, lihat Klausa WHERE (WHERE_condition). |
| UDF |
SQL | Session | odps.optimizer.enable.range.partial.repartitioning | Menentukan apakah akan mengaktifkan mekanisme penghapusan shuffle untuk tabel range-clustered. |
|
|
SQL | Session | odps.optimizer.merge.partitioned.table | Saat kueri berulang kali menggunakan tabel partisi yang sama, aktifkan properti ini untuk menggabungkan partisi. Tindakan ini meminimalkan I/O pada tabel dan meningkatkan performa. |
| SELECT |
SQL | Session | odps.optimizer.skew.join.topk.num | Mengatur jumlah Kunci panas yang dikumpulkan pengoptimal saat menjalankan operasi agregat. Untuk informasi selengkapnya, lihat SKEWJOIN HINT. | - | SKEWJOIN HINT |
SQL | Session | odps.optimizer.stat.collect.auto | Menentukan apakah akan mengaktifkan fitur Freeride, yang secara otomatis mengumpulkan statistik kolom untuk tabel. Untuk informasi selengkapnya tentang pengumpulan statistik pengoptimal, lihat Pengoptimal. |
|
|
SQL | Session | odps.optimizer.stat.collect.plan | Menentukan rencana pengumpulan untuk mengumpulkan statistik pada kolom tertentu. Untuk informasi selengkapnya tentang pengumpulan statistik pengoptimal, lihat Pengoptimal. | - |
|
SQL | Session | odps.sql.external.net.vpc | Menentukan apakah akan mengaktifkan dukungan VPC untuk tabel eksternal. Untuk informasi selengkapnya, lihat Tabel eksternal Hologres. |
| CREATE TABLE |
SQL | Session | odps.sql.groupby.position.alias | Menentukan apakah akan memperlakukan konstanta bilangan bulat dalam klausa GROUP BY sebagai ordinal kolom dari daftar SELECT. |
|
|
SQL | Session | odps.sql.groupby.skewindata | Menentukan apakah akan mengaktifkan mekanisme anti-skew untuk operasi GROUP BY. |
| GROUP BY |
SQL | Session | odps.sql.orderby.position.alias | Menentukan apakah akan memperlakukan konstanta bilangan bulat dalam klausa ORDER BY sebagai ordinal kolom dari daftar SELECT. |
|
|
SQL | Session | odps.sql.mapjoin.memory.max | Mengatur ukuran memori untuk tabel kecil yang dimuat ke dalam memori selama operasi MAPJOIN. Satuan: MiB. Catatan Parameter ini juga tunduk pada batas total memori global di tingkat Task. Batas atas global untuk total memori bagi beberapa tabel kecil dalam Task yang sama adalah | Rentang nilai: 0 MiB~8.192 MiB | JOIN |
SQL | Session | odps.sql.distributed.map.join.memory.max | Mengatur ukuran memori untuk setiap instans HashTableBuilder selama operasi MAPJOIN. Nilai defaultnya adalah 2.048. Satuan: MiB. | Rentang: 0 MiB hingga 8.192 MiB | JOIN |
SQL | Session | odps.sql.python.version | Mengatur versi Python untuk menjalankan Pernyataan SQL. |
|
|
SQL | Session | odps.sql.select.output.format | Menentukan apakah akan menampilkan baris header dalam hasil dari client MaxCompute. Untuk informasi selengkapnya tentang cara menggunakan client MaxCompute, lihat Terhubung menggunakan client (odpscmd). |
| ALL |
SQL | Session | odps.sql.unstructured.data.oss.use.https | Menentukan apakah akan mengambil data melalui HTTPS saat Anda mengakses tabel eksternal. Untuk informasi selengkapnya tentang tabel eksternal OSS, lihat Tabel eksternal ORC. |
| ALL |
SQL | Session | odps.sql.decimal.tostring.trimzero | Menentukan apakah akan menghapus nol di akhir setelah titik desimal untuk Tipe data Decimal. Nilai defaultnya adalah |
| CAST |
SQL | Session | odps.sql.unstructured.tablestore.put.row | Menentukan apakah akan menggunakan mode penulisan PutRow untuk tabel eksternal Tablestore. Catatan Untuk informasi selengkapnya tentang PutRow, lihat PutRow. |
| ALL |
SQL | Session | odps.sql.unstructured.external.max.dop | Mengatur konkurensi maksimum untuk worker yang mengakses tabel eksternal. | Bilangan bulat lebih besar dari 0. | Kueri dan penulisan tabel eksternal |
SQL | Session/Proyek | odps.sql.unstructured.file.pattern.black.list | Saat MaxCompute SQL membaca tabel eksternal dari lokasi OSS atau HDFS, sistem dapat secara otomatis mengabaikan file | Nilai: | Kueri tabel eksternal |
SQL | Session | odps.meta.exttable.stats.onlinecollect | Data dari tabel eksternal berada di data lake. Karena sifatnya yang terbuka, MaxCompute tidak dapat mengelola metadatanya secara lokal. Tanpa statistik, pengoptimal sering kali menghasilkan rencana eksekusi yang konservatif, sehingga mengakibatkan performa yang buruk. Saat fitur ini diaktifkan, pengoptimal dapat mengumpulkan statistik tabel selama eksekusi kueri untuk mengidentifikasi tabel kecil. Hal ini memungkinkan pengoptimal meningkatkan Rencana kueri dengan menggunakan teknik seperti hash join, pengoptimalan urutan join, pengurangan shuffle, dan pipeline eksekusi yang lebih pendek. | True: Diaktifkan. False (default): Dinonaktifkan. | Kueri tabel eksternal |
SQL | Proyek | odps.sql.allow.fullscan | Menentukan apakah akan mengizinkan pemindaian tabel penuh dalam proyek. Pemindaian tabel penuh sangat memakan resource. Menonaktifkan fitur ini disarankan untuk performa yang lebih baik. |
| SELECT |
SQL | Proyek | odps.table.lifecycle | Menentukan apakah tabel dalam proyek harus memiliki lifecycle yang dikonfigurasi. |
| CREATE TABLE |
SQL | Proyek | odps.table.lifecycle.value | Mengatur lifecycle tabel dalam satuan hari. | Rentang: 1 hingga 37.231. Default: 37.231. | CREATE TABLE |
SQL | Proyek | READ_TABLE_MAX_ROW | Mengatur jumlah baris yang dikembalikan oleh pernyataan SELECT. | Rentang: 1 hingga 10.000. Default: 10.000. | SELECT |
SQL | Proyek | odps.output.field.formatter | Mengatur aturan penyembunyian data dinamis untuk hasil kueri SQL. Untuk informasi selengkapnya tentang penyembunyian data dinamis di MaxCompute, lihat Penyembunyian data dinamis. | Aturan penyembunyian data dinamis kustom. | SELECT |
SQL | Proyek | odps.sql.acid.table.enable | Menentukan apakah akan mengaktifkan mekanisme ACID. Untuk informasi selengkapnya tentang ACID, lihat Semantik ACID. |
| ALL |
SQL | Session/Proyek | odps.io.oss.use.vipserver | Menentukan apakah akan menggunakan VIPServer untuk mengakses OSS bagi tabel eksternal. Jika properti ini tidak diaktifkan, SLB akan digunakan. VIPServer menyediakan batas traffic yang lebih tinggi dan mendukung kontrol traffic, namun memperkenalkan risiko stabilitas, seperti kegagalan kueri. Tinjau risiko ini sebelum mengaktifkan properti ini. |
| Kueri tabel eksternal |
SQL | Session/Proyek | odps.sql.executionengine.enable.string.to.date.full.format | Untuk mengonversi string tanggal yang mencakup jam, menit, dan detik, atur properti ini ke True. Nilai defaultnya adalah False. |
| CAST |
SQL | Session/Proyek | odps.sql.executionengine.enable.rand.time.seed | Jika properti ini diatur ke False, fungsi Rand menggunakan ID instans saat ini sebagai seed untuk menginisialisasi bilangan acak. Hal ini memastikan idempotensi fungsi. Jika properti ini diatur ke True, fungsi Rand menggunakan waktu sistem saat ini sebagai seed. Dalam kasus ini, fungsi Rand tidak idempoten dan tidak dapat digunakan sebagai kunci shuffle. Menjalankan ulang job akan menghasilkan hasil yang berbeda. Nilai defaultnya adalah False. |
| RAND |
SQL | Session/Proyek | odps.sql.type.system.odps2 | Mengaktifkan atau menonaktifkan Tipe data 2.0. Untuk informasi selengkapnya tentang Tipe data 2.0, lihat Tipe data versi 2.0. |
| Fungsi tambahan MaxCompute 2.0 |
SQL | Session/Proyek | odps.sql.type.json.enable | Mengaktifkan atau menonaktifkan Tipe data JSON. Untuk informasi selengkapnya tentang Tipe data JSON, lihat Tipe data JSON. |
| Tipe data JSON MaxCompute |
SQL | Session/Proyek | odps.sql.hive.compatible | Mengaktifkan atau menonaktifkan mode kompatibel Hive. Saat diaktifkan, MaxCompute mendukung berbagai sintaks khusus Hive, seperti inputRecordReader, outputRecordReader, dan Serde. Untuk informasi selengkapnya tentang tipe data yang kompatibel, lihat Versi tipe data kompatibel Hive. |
| ALL |
SQL | Session/Proyek | odps.sql.metering.value.max | Mengatur batas konsumsi untuk satu kueri SQL. Untuk informasi selengkapnya tentang Pemantauan konsumsi, lihat Pemantauan, Peringatan, dan kontrol konsumsi. | - | ALL |
SQL | Session/Proyek | odps.sql.timezone | Mengatur zona waktu untuk proyek MaxCompute. Untuk informasi selengkapnya tentang zona waktu, lihat Operasi konfigurasi zona waktu. | - | ALL |
SQL | Session/Proyek | odps.sql.unstructured.oss.commit.mode | Menentukan apakah akan mengaktifkan unggah multi-bagian untuk menulis data ke tabel eksternal OSS. Untuk informasi selengkapnya, lihat Menulis data ke OSS. |
| INSERT OVERWRITE |
SQL | Session/Proyek | odps.sql.groupby.orderby.position.alias | Menentukan apakah akan memperlakukan konstanta bilangan bulat dalam klausa GROUP BY dan ORDER BY sebagai ordinal kolom dari daftar SELECT. Catatan Untuk proyek yang sudah ada, mengaktifkan properti ini di tingkat proyek mungkin memengaruhi job yang ada. Sebelum mengubah properti ini, pastikan job yang masih berjalan tetap berfungsi dengan benar. Jika tidak, atur properti ini di tingkat session. |
|
|
SQL | Session/Proyek | odps.ext.oss.orc.native | Menentukan apakah akan menggunakan reader ORC native untuk membaca tabel. |
| SELECT |
SQL | Session | odps.sql.job.max.time.hours | Mengatur durasi eksekusi maksimum untuk satu job. | Rentang: 1 hingga 72. Default: 24. | Job SQL |
Penagihan | Session | odps.task.quota.preference.tag | Dalam proyek yang menggunakan resource subscription, properti ini menetapkan job ke kelompok Kuota secondary tertentu. Jika tag kuota job cocok dengan tag kelompok kuota, job akan dijadwalkan ke kelompok tersebut dengan prioritas. Jika tidak, job akan dijadwalkan ke kelompok kuota default proyek. Jalankan pernyataan berikut untuk mengatur properti. Catatan Properti ini hanya berlaku untuk job SQL. | tag_name adalah tag dari kelompok kuota di MaxCompute Housekeeper. Kelompok kuota harus berada di Wilayah yang sama dengan pemilik proyek tempat job tersebut berada. tag_name hanya boleh berisi huruf, angka, dan garis bawah (_). | ALL |
Penagihan | Session | odps.task.wlm.quota | Menentukan kelompok kuota (berdasarkan nama) yang akan digunakan untuk menjalankan task dalam session saat ini. | - | ALL |
Keamanan | Proyek | odps.forbid.fetch.result.by.bearertoken | Menentukan apakah akan mencegah tab Result di Logview menampilkan hasil job. Gunakan properti ini untuk melindungi data. |
| ALL |
Keamanan | Proyek | LabelSecurity | Menentukan apakah akan mengaktifkan mekanisme LabelSecurity. Untuk informasi selengkapnya tentang mekanisme LabelSecurity, lihat Kontrol akses berbasis label. |
| ALL |
Keamanan | Proyek | CheckPermissionUsingACL | Menentukan apakah akan mengaktifkan mekanisme otorisasi daftar kontrol akses (ACL). Untuk informasi selengkapnya tentang otorisasi berbasis ACL, lihat Izin MaxCompute. |
| ALL |
Keamanan | Proyek | CheckPermissionUsingPolicy | Menentukan apakah akan mengaktifkan mekanisme otorisasi berbasis kebijakan. Untuk informasi selengkapnya tentang otorisasi berbasis kebijakan, lihat Kontrol akses berbasis kebijakan. |
| ALL |
Keamanan | Proyek | ObjectCreatorHasAccessPermission | Menentukan apakah pembuat objek memiliki izin akses pada objek tersebut secara default. |
| ALL |
Keamanan | Proyek | ObjectCreatorHasGrantPermission | Menentukan apakah pembuat objek memiliki izin pemberian pada objek tersebut secara default. |
| ALL |
Keamanan | Proyek | ProjectProtection | Menentukan apakah akan mengaktifkan mekanisme perlindungan data. Untuk informasi selengkapnya tentang mekanisme perlindungan data, lihat Mekanisme perlindungan data. |
| ALL |
Keamanan | Proyek | odps.output.field.formatter | Mengatur aturan penyembunyian data dinamis untuk hasil kueri SQL. Untuk informasi selengkapnya tentang penyembunyian data dinamis, lihat Penyembunyian data dinamis. | Aturan penyembunyian data dinamis kustom. | SELECT |
Keamanan | Proyek | odps.security.ip.whitelist | Mengatur daftar putih IP untuk client yang mengakses proyek melalui internet publik, yang biasanya digunakan untuk integrasi layanan cloud. Untuk informasi selengkapnya tentang daftar putih IP, lihat Mengelola daftar putih IP. | Daftar alamat IP, dipisahkan dengan koma (,). | ALL |
Keamanan | Proyek | odps.security.vpc.whitelist | Menentukan daftar putih IP untuk mengakses proyek dari VPC. Untuk informasi selengkapnya tentang daftar putih IP, lihat Mengelola daftar putih IP. | Format: RegionID_VPCID[IP Address] | ALL |
Tipe data | Proyek | odps.sql.decimal.odps2 | Mengaktifkan atau menonaktifkan Tipe data DECIMAL(precision, scale) dari Tipe data 2.0. Untuk informasi selengkapnya tentang tipe data, lihat Tipe data versi 2.0. |
| ALL |
Penyimpanan data | Proyek | odps.timemachine.retention.days | Mengatur periode retensi untuk Cadangan data. Untuk informasi selengkapnya tentang Cadangan data, lihat Cadangan data lokal. | Rentang dalam hari: 0 hingga 30. Default: 1. | ALL |
Metadata | Proyek | odps.schema.evolution.enable | Mengaktifkan evolusi skema. |
| Evolusi skema. |
Mengkueri parameter flag
Anda dapat mengkueri parameter flag pada tingkat proyek atau session.
Tingkat proyek: Di client MaxCompute (odpscmd), jalankan
setproject;untuk menampilkan semua parameter flag proyek tersebut.Tingkat session: Lihat parameter tingkat session di Logview.