Tüm Ürünler
Search
Belge Merkezi

PolarDB:PolarSearch verilerini manuel olarak yedekleme ve geri yükleme

Son Güncelleme:Oct 07, 2026

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.

Not

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

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

{repo-name}

Depo için özel bir ad.

type

Deponun türü. Bu değer oss olarak ayarlanmalıdır.

endpoint

OSS paketinizin uç noktası. Daha fazla bilgi için bkz. Bölgeler ve Uç Noktalar.

bucket

OSS paketinizin adı.

base_path

(İsteğe bağlı) Anlık görüntü dosyalarının depolandığı OSS paketindeki kök dizin yolu.

region

Paketin bulunduğu bölge.

access_key

AccessKey ID bilginiz.

secret_key

AccessKey Secret bilginiz.

session_token

(İsteğe bağlı) RAM rolünüz için STS Token.

Önemli

Bir STS Token kullanıyorsanız, access_key ve secret_key parametrelerini de STS Token'dan alınan değerlerle ayarlamanız gerekir. Bir STS Token kullanmıyorsanız uzun vadeli AccessKey ID ve AccessKey Secret bilgilerinizi kullanın.

compress

(İ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.

chunk_size

(İ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

wait_for_completion

Anlık görüntü işleminin tamamlanmasının beklenip beklenmeyeceğini belirtir. Varsayılan değer false'tur.

  • Eşzamanlı yürütme: wait_for_completion=true olarak ayarlarsanız komut, sonuç döndürmeden önce anlık görüntünün oluşturulmasını bekler.

  • Eşzamansız yürütme: wait_for_completion=false olarak ayarlarsanız komut hemen döner ve anlık görüntü arka planda oluşturulur. Aşağıdaki komutu çalıştırarak anlık görüntü durumunu kontrol edebilirsiniz. Yanıttaki state alanı SUCCESS olduğunda işlem tamamlanmış demektir.

    GET /_snapshot/{repo-name}/{snapshot-name}/_status

İstek gövdesi parametreleri

indices

Yedeklenecek dizinler. Joker karakterini (*) kullanabilir ve birden çok dizin adını virgülle (,) ayırabilirsiniz. Varsayılan olarak tüm dizinler yedeklenir.

Not

Joker karakterini (*) kullanmak sistem tablolarını da yedekler. Sistem tablolarının yedeklenmesini veya geri yüklenmesini önlemek için yalnızca ihtiyaç duyduğunuz dizinleri belirtin veya sistem tablolarını dışlamak için tire (-) kullanın.

ignore_unavailable

Mevcut olmayan bir dizinin yok sayılmasını ve anlık görüntünün devam etmesini belirtir. Varsayılan değer false'tur ve bu durumda işlem başarısız olur.

partial

Kısmi anlık görüntülere izin verilip verilmeyeceğini belirtir. true olarak ayarlanırsa bazı parçalar başarısız olsa bile başarılı parçalardaki veriler kaydedilir. Varsayılan değer false'tur.

Ö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:

Not

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

wait_for_completion

Anlık görüntü geri yüklemenin tamamlanmasının beklenip beklenmeyeceğini belirtir. Varsayılan değer false'tur.

  • Eşzamanlı yürütme: wait_for_completion=true olarak ayarlarsanız komut, geri yükleme tamamlanana kadar bekler ve ardından döner.

  • Eşzamansız yürütme: wait_for_completion=false olarak ayarlarsanız komut hemen döner ve geri yükleme işi arka planda çalışır. Aşağıdaki komutu çalıştırarak dizin geri yükleme ilerlemesini kontrol edebilirsiniz. stage alanı DONE olduğunda geri yükleme tamamlanmış demektir.

    GET /{index-name}/_recovery

İstek gövdesi parametreleri

indices

Geri yüklenecek dizinleri belirtir. Joker karakteri * desteklenir. Birden çok dizin virgül , ile ayrılır. Varsayılan olarak tüm dizinler seçilir.

ignore_unavailable

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 false'tur ve bu durumda işlem başarısız olur.

partial

Kısmi anlık görüntü oluşturulup oluşturulmayacağını belirtir. true olarak ayarlanırsa bazı parçalar başarısız olsa bile başarılı parçalardaki veriler kaydedilir. Varsayılan değer false'tur.

index_settings

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.

ignore_index_settings

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
  }'