Klien Tablestore menyediakan berbagai metode untuk melakukan operasi pada tabel dan data di Tablestore. Topik ini menjelaskan cara menggunakan Tablestore SDK untuk PHP untuk menginisialisasi klien.
Topik ini menggunakan Pasangan Kunci Akses akun Alibaba Cloud sebagai contoh. Untuk menginisialisasi klien menggunakan kredensial lainnya, lihat Gunakan Pasangan Kunci Akses Pengguna RAM untuk Mengakses Tablestore dan Gunakan Kredensial Akses Sementara dari STS untuk Mengakses Tablestore.
Persiapan
Sebelum menginisialisasi klien Tablestore, peroleh informasi instans, instal Tablestore SDK, dan konfigurasikan kredensial akses.
Peroleh informasi tentang instans yang ingin Anda akses
ID Wilayah: ID wilayah dari instans. Sebagai contoh, ID wilayah China (Hangzhou) adalah cn-hangzhou.
Nama instans dan Titik Akhir: Setiap instans Tablestore memiliki titik akhir unik. Aplikasi Anda harus menentukan titik akhir untuk melakukan operasi pada tabel dan data. Untuk memperoleh titik akhir, ikuti langkah-langkah berikut:
Masuk ke Konsol Tablestore.
Di bilah navigasi atas, pilih kelompok sumber daya dan wilayah.
Di halaman Overview, klik alias instans atau klik Manage Instance di kolom Actions.
Di tab Instance Details, lihat nama instans dan titik akhir.
PentingSecara default, akses Internet dinonaktifkan untuk instans baru. Untuk mengakses sumber daya di instans melalui Internet, Anda harus mengaktifkan akses Internet untuk instans.
Instal Tablestore SDK
Untuk informasi lebih lanjut, lihat Instal Tablestore SDK untuk PHP.
Konfigurasikan kredensial akses
Buat Pasangan Kunci Akses untuk akun Alibaba Cloud atau Pengguna RAM Anda, lalu konfigurasikan Pasangan Kunci Akses sebagai variabel lingkungan.
Setelah menyelesaikan konfigurasi, mulai ulang atau segarkan lingkungan pengembangan Anda, seperti IDE, antarmuka baris perintah, aplikasi desktop, atau layanan latar belakang, untuk memuat variabel lingkungan sistem terbaru. Untuk informasi lebih lanjut, lihat Konfigurasikan Kredensial Akses.
Linux
Jalankan perintah berikut di antarmuka baris perintah untuk menambahkan pengaturan variabel lingkungan ke file
~/.bashrc.echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrcJalankan perintah berikut untuk membuat perubahan tersebut berlaku:
source ~/.bashrcJalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
macOS
Jalankan perintah berikut di terminal untuk memeriksa tipe Shell default.
echo $SHELLLakukan operasi berdasarkan tipe Shell default.
Zsh
Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file
~/.zshrc.echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrcJalankan perintah berikut untuk membuat perubahan tersebut berlaku:
source ~/.zshrcJalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Bash
Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file
~/.bash_profile.echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profileJalankan perintah berikut untuk membuat perubahan tersebut berlaku:
source ~/.bash_profileJalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:
echo $TABLESTORE_ACCESS_KEY_ID echo $TABLESTORE_ACCESS_KEY_SECRET
Windows
CMD
Jalankan perintah berikut di CMD untuk menetapkan variabel lingkungan.
setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID" setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"Setelah memulai ulang CMD, jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:
echo %TABLESTORE_ACCESS_KEY_ID% echo %TABLESTORE_ACCESS_KEY_SECRET%
PowerShell
Jalankan perintah berikut di PowerShell:
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User) [Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)
Inisialisasi klien
Anda harus menginisialisasi klien dan memanggil metode yang disediakan oleh klien untuk mengakses Tablestore. Tablestore SDK untuk Python menyediakan klien untuk Model Kolom Lebar.
Untuk mengakses sumber daya Tablestore melalui HTTPS, Anda harus menginstal ekstensi OpenSSL PHP.
Model Kolom Lebar
Kode sampel berikut memberikan contoh cara menginisialisasi klien Tablestore, menanyakan daftar tabel data dalam instans, dan menampilkan daftarnya di Konsol Tablestore:
<?php
// Jalur ini adalah jalur relatif. Ubah jalurnya sesuai kebutuhan.
require (__DIR__ . '/../../vendor/autoload.php');
use Aliyun\OTS\OTSClient as OTSClient;
// Ganti yourInstanceName dengan nama instans Anda.
$instanceName = "yourInstanceName";
// Ganti yourEndpoint dengan titik akhir instans Anda.
$endpoint = "yourEndpoint";
// Dapatkan AccessKey ID dan Rahasia AccessKey dari variabel sistem.
$accessKeyId = getenv('TABLESTORE_ACCESS_KEY_ID');
$accessKeySecret = getenv('TABLESTORE_ACCESS_KEY_SECRET');
// Inisialisasi klien Tablestore.
$client = new OTSClient(array(
'EndPoint' => $endpoint,
'AccessKeyID' => $accessKeyId,
'AccessKeySecret' => $accessKeySecret,
'InstanceName' => $instanceName,
));
// Daftar tabel data dalam instans dan cetak daftarnya ke konsol.
$response = $client->listTable (array ());
print json_encode ($response);