PolarSearch anlık görüntü özelliğini kullanarak kümenizdeki dizin verilerini kendi Object Storage Service (OSS) paketinize yedeklemenizi veya bir OSS paketinden veri geri yüklemenizi sağlar. Bu özellik, PolarSearch kümeleri arasında çapraz küme geçişi ve özel yedekleme ile kurtarma senaryolarında kullanılabilir. Veri koruma ve aktarımı için esnek ve düşük maliyetli bir çözüm sunar.
Bu özellik şu anda önizleme aşamasındadır. Özelliği kullanmak için bir destek talebi oluşturun ve etkinleştirilmesini isteyin.
Ön koşullar
-
PolarSearch sürümünüzün 3.0.0.0.0 veya üzeri olması gerekir.
NotPolarSearch sürümünüzü
version.numberalanında kontrol etmek için arama uç noktası üzerinden PolarSearch'e erişin bağlantısını kullanabilirsiniz. Anlık görüntüleri depolamak için Alibaba Cloud Object Storage Service (OSS) hizmetini etkinleştirmiş ve bir paket oluşturmuş olmanız gerekir.
AliyunOSSFullAccessilkesi eklenmiş bir RAM kullanıcısına ihtiyacınız vardır. Daha fazla bilgi için bkz. RAM kullanıcısına izin ekleme.
Faturalama
Anlık görüntü özelliği ücretsizdir. Anlık görüntü dosyalarını OSS paketinizde saklamak depolama ve istek ücretlerine tabidir. Daha fazla bilgi için bkz. OSS faturalandırmasına genel bakış.
Anlık görüntü deposu kaydetme
Anlık görüntü özelliğini kullanmadan önce bir anlık görüntü deposu kaydetmeniz ve bunu OSS paketinizle ilişkilendirmeniz gerekir. Depoyu oluşturmak için aşağıdaki API'yi kullanın:
PUT /_snapshot/{repo-name}
{
"type": "oss",
"settings": {
"endpoint": "{endpoint}",
"bucket": "{bucket-name}",
"base_path": "{path-name}",
"region": "{region}",
"access_key": "{your-AccessKey-ID}",
"secret_key": "{your-AccessKey-Secret}",
"session_token": "{your-STS-Token}",
"compress": true,
"chunk_size": "512mb"
}
}
Parametre açıklaması
Parametre | Açıklama |
| Depo için özel bir ad. |
|
Deponun türü. Bu değer |
| OSS paketinizin uç noktası. Daha fazla bilgi için bkz. Bölgeler ve Uç Noktalar. |
| OSS paketinizin adı. |
| (İsteğe bağlı) Anlık görüntü dosyalarının depolandığı OSS paketindeki kök dizin yolu. |
| Paketin bulunduğu bölge. |
|
|
AccessKey ID bilginiz. |
|
|
AccessKey Secret bilginiz. |
|
|
(İsteğe bağlı) RAM rolünüz için STS Token. Önemli
Bir STS Token kullanıyorsanız, |
|
|
(İsteğe bağlı) Dizin eşlemeleri ve ayarları gibi anlık görüntü meta veri dosyalarının sıkıştırılıp sıkıştırılmayacağını belirtir. Bu parametre veri dosyalarını etkilemez. Varsayılan değer false'tur. |
|
|
(İsteğe bağlı) Anlık görüntü işlemi sırasında parçalı yüklemeler için boyut sınırı. Bu boyuttan büyük veriler OSS'e parçalar halinde yüklenir. Varsayılan değer 1 GB'tır. |
Örnek
Aşağıdaki komuttaki parametreleri kendi bilgilerinizle değiştirin.
curl -X PUT "https://{pc-endpoint}:3001/_snapshot/{repo-name}" \
-u "{username}:{passwd}" \
-H "Content-Type: application/json" \
-d '{
"type": "oss",
"settings": {
"endpoint": "{endpoint}",
"bucket": "{bucket-name}",
"base_path": "{path-name}",
"region": "{region}",
"access_key": "{your-AccessKey-ID}",
"secret_key": "{your-AccessKey-Secret}"
}
}'
Anlık görüntü oluşturma: verileri OSS'e yedekleme
Bir anlık görüntü deposu kaydettikten sonra belirli bir dizin için anlık görüntü oluşturmak üzere aşağıdaki API'yi kullanın:
PUT /_snapshot/{repo-name}/{snapshot-name}?wait_for_completion=true
{
"indices": "{index-name}",
"ignore_unavailable":false
}
Parametre açıklaması
Parametre kategorisi | Parametre adı | Açıklama |
İstek parametresi |
| Anlık görüntü işleminin tamamlanmasının beklenip beklenmeyeceğini belirtir. Varsayılan değer
|
İstek gövdesi parametreleri |
| Yedeklenecek dizinler. Joker karakterini ( Not Joker karakterini ( |
| Mevcut olmayan bir dizinin yok sayılmasını ve anlık görüntünün devam etmesini belirtir. Varsayılan değer | |
| Kısmi anlık görüntülere izin verilip verilmeyeceğini belirtir. |
Örnek
Aşağıdaki komuttaki parametreleri kendi bilgilerinizle değiştirin.
curl -X PUT "https://{pc-endpoint}:3001/_snapshot/{repo-name}/{snapshot-name}?wait_for_completion=true" \
-u "{username}:{passwd}" \
-H "Content-Type: application/json" \
-d '{
"indices": "{index-name}",
"ignore_unavailable": false
}'
Anlık görüntüleri görüntüleme
OSS anlık görüntü deponuzdaki tüm anlık görüntüler hakkında bilgi görüntülemek için aşağıdaki API'yi kullanın:
GET /_snapshot/{repo-name}/_all?pretty
Örnek
Aşağıdaki komuttaki parametreleri kendi bilgilerinizle değiştirin.
curl -X GET "https://{pc-endpoint}:3001/_snapshot/{repo-name}/_all?pretty" -u "{username}:{passwd}"
Veri geri yükleme
Belirli bir anlık görüntüden dizin verilerini geri yüklemek için aşağıdaki komutu çalıştırın:
Bir PolarSearch kümesinden başka bir PolarSearch kümesine anlık görüntü geri yüklemek için hedef PolarSearch kümesinin kaynak PolarSearch kümesiyle aynı anlık görüntü deposunu kaydetmesi gerekir. Geri yükleme işlemi aynı PolarSearch kümesi içinde gerçekleşiyorsa yeniden kayıt yapmanıza gerek yoktur ve veri geri yüklemeyi doğrudan çalıştırabilirsiniz.
POST /_snapshot/{repo-name}/{snapshot-name}/_restore?wait_for_completion=true
{
"indices": "{index-name}",
"ignore_unavailable": true
}
Parametreler
Parametre kategorisi | Parametre adı | Açıklama |
İstek parametresi |
| Anlık görüntü geri yüklemenin tamamlanmasının beklenip beklenmeyeceğini belirtir. Varsayılan değer
|
İstek gövdesi parametreleri |
| Geri yüklenecek dizinleri belirtir. Joker karakteri |
| Dizin mevcut değilse dizinin yok sayılmasını ve anlık görüntü oluşturma işleminin devam etmesini belirtir. Varsayılan değer | |
| Kısmi anlık görüntü oluşturulup oluşturulmayacağını belirtir. | |
| Geri yükleme sırasında anlık görüntüdeki dizin ayarlarını geçersiz kılar. Örneğin, çoğaltma sayısını hedef kümenin yapılandırmasıyla eşleşecek şekilde değiştirebilirsiniz. | |
| Geri yükleme sırasında yok sayılacak dizin ayarlarının listesi. Bu genellikle kaynak kümeye özel ayarları yok saymak için kullanılır. |
Örnek
Aşağıdaki komuttaki parametreleri kendi bilgilerinizle değiştirin.
curl -X POST "https://{pc-endpoint}:3001/_snapshot/{repo-name}/{snapshot-name}/_restore?wait_for_completion=true" \
-u "{username}:{passwd}" \
-H "Content-Type: application/json" \
-d '{
"indices": "{index-name}",
"ignore_unavailable": true
}'