PolarPlus adalah client yang kompatibel dengan Oracle untuk PolarDB.
Unduh client
PolarPlus disediakan dalam bentuk paket terkompresi dan tidak memerlukan instalasi. Untuk menggunakannya di Linux, unduh dan ekstrak paket tersebut. Struktur direktori folder hasil ekstraksi ditampilkan di bawah ini. File polarplus adalah file yang dapat dieksekusi. Jika Anda menambahkan jalur direktori polarplus_release/ ke variabel sistem PATH, Anda dapat menjalankan perintah polarplus.
polarplus_release
├── polarplus -> ./polarplus.sh
├── polarplus.sh
├── polarplus.jar
├── login.sql
├── etc
│ └── sysconfig
├── help
└── libPetunjuk penggunaan PolarPlus
Pendahuluan
PolarPlus adalah utilitas antarmuka baris perintah untuk PolarDB. PolarPlus mendukung perintah SQL, perintah PolarPlus, blok anonim PL/SQL, fungsi, dan prosedur tersimpan. Tool ini menyediakan fitur-fitur berikut:
Kueri objek database tertentu.
Eksekusi prosedur tersimpan.
Format output perintah SQL.
Eksekusi skrip batch.
Eksekusi perintah sistem operasi.
Perekaman output.
Perbedaan dari tool native
PolarPlus dirancang khusus untuk PolarDB dan mendukung fitur-fitur umum dari tool Oracle SQL*Plus.
Anda dapat menggunakan PolarDB-Tools untuk mengelola kluster PolarDB. Kumpulan tool ini dirancang untuk PolarDB for PostgreSQL (Compatible with Oracle). Tool psql yang disediakan dalam kumpulan ini mendukung blok anonim PL/SQL, fungsi, dan prosedur tersimpan yang menggunakan sintaksis Oracle.
Konfigurasikan PolarPlus
Tool PolarPlus memiliki dependensi berikut:
Lingkungan Java Development Kit (JDK) 1.8 (x64).
OpenSSL versi 1.1 (x64).
Gunakan perintah
wgetuntuk mengunduh dan mengekstrak PolarPlus. Untuk tautan unduhan, lihat Unduh client.Buka file
polarplus.sh.Ubah baris
export base="{pwd}/polarplus"dan ganti{pwd}dengan jalur mutlak direktoripolarplus.Gunakan perintah berikut di server untuk menjalankan PolarPlus:
polarplus [ -S[ILENT ] ] [ login | /NOLOG ] [ @scriptfile[.ext ] ]Parameter
Deskripsi
-S[ILENT ]
Jika ditentukan, parameter ini menonaktifkan banner logon PolarPlus dan semua prompt.
login
Informasi logon yang digunakan untuk terhubung ke server database dan database.
Informasi logon menggunakan format berikut:
username[/password][@{connectstring | variable } ]Untuk informasi lebih lanjut, lihat Informasi logon.
variable adalah variabel yang didefinisikan dalam file login.sql. File ini berisi string koneksi database.
/NOLOG
Jika Anda menjalankan PolarPlus dengan opsi
/NOLOG, koneksi ke database tidak dibuat saat PolarPlus dimulai. Jangan gunakan mode ini jika Anda ingin menggunakan perintah SQL atau perintah PolarPlus untuk terhubung ke database.CatatanSetelah menjalankan PolarPlus dengan opsi /NOLOG, Anda dapat menggunakan perintah CONNECT untuk terhubung ke database.
scriptfile[.ext ]
scriptfile adalah nama file di direktori kerja saat ini. File tersebut berisi perintah SQL dan perintah PolarPlus yang dieksekusi secara otomatis setelah PolarPlus dimulai.
.extadalah ekstensi nama file. Jika ekstensi file adalah sql, Anda dapat menghilangkan ekstensi.sqlsaat menentukan file skrip. Beri nama file skrip dengan ekstensi saat membuatnya. Jika tidak, PolarPlus tidak dapat mengakses file tersebut.CatatanPolarPlus selalu menggunakan ekstensi
.sqluntuk nama file yang tidak memiliki ekstensi yang ditentukan.Tabel 1. Informasi logon
Parameter
Deskripsi
username
Username database yang digunakan untuk terhubung ke database.
password
Password yang terkait dengan username yang ditentukan.
connectstring
String koneksi database dengan format berikut:
host[:port][/dbname][?ssl={true | false}]host adalah hostname atau alamat IP server database.
CatatanJika
connectstring,variable, atauNOLOGtidak ditentukan, host default adalah host lokal.Jika Anda terhubung menggunakan Alamat IPv6, alamat IP harus diapit tanda kurung siku.
Berikut contoh koneksi menggunakan Alamat IPv6:
polarplus polardb/password@[fe80::20c:29ff:fe7c:78b2]:5444/polardbport adalah nomor port yang menerima koneksi di server database.
CatatanJika tidak ditentukan, nilai default-nya adalah 5444.
dbname adalah nama database yang akan dihubungi.
CatatanJika tidak ditentukan, nilai default-nya adalah polardb.
Jika koneksi SSL diperlukan, sertakan parameter
?ssl=truedalam string koneksi. String koneksi harus berisihost:port. Jika parameter SSL tidak ditentukan, nilai default-nya adalah false.
Berikut contoh koneksi:
polarplus polardb/password@pc-bp1zxxxxxxxxxxx.o.polardb.rds.aliyuncs.com:1521/polardbCatatanPolarPlus hanya digunakan untuk terhubung ke versi 1.0 PolarDB for PostgreSQL (Compatible with Oracle). Untuk terhubung ke versi 2.0 PolarDB for PostgreSQL (Compatible with Oracle), unduh PolarPlus2. Struktur direktori dan penggunaannya mirip dengan PolarPlus. Cukup ganti
polarplusdenganpolarplus2dalam direktori dan perintah.