Tam yedekleme dosyasını içe aktarma - - Alibaba Cloud Dokümantasyon Merkezi

Not

Tam yedekleme dosyası, kendi MySQL veritabanınızın verilerini içerir. Kendi MySQL veritabanınızın verilerini tam yedekleme dosyasından bir ApsaraDB RDS for MySQL örneğine geri yükleyebilirsiniz.

Bu işlemi çağırmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

Kendi MySQL veritabanınız MySQL 5.7 sürümünde çalışıyor olmalıdır ve veritabanının verileri XtraBackup kullanılarak yedeklenmiş, adı _qp.xb ile biten bir tam yedekleme dosyası olarak kaydedilmiş olmalıdır. Daha fazla bilgi için bkz. Kendi MySQL 5.7 veritabanınızın tam yedekleme verilerini bir ApsaraDB RDS for MySQL örneğine geçirme.
Kendi MySQL veritabanınızın tam yedekleme dosyası, ApsaraDB RDS for MySQL örneğinin bulunduğu bölgedeki bir Object Storage Service (OSS) paketinde depolanmış olmalıdır. Daha fazla bilgi için bkz. Kendi MySQL 5.7 veritabanınızın tam yedekleme verilerini bir ApsaraDB RDS for MySQL örneğine geçirme.

Not

Bu işlem yalnızca MySQL 5.7 için desteklenir.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık olması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	ImportUserBackupFile	Gerçekleştirmek istediğiniz işlem. Değer ImportUserBackupFile olarak ayarlanmalıdır.
BackupFile	String	Evet	{"Bucket":"test", "Object":"test/test_db_employees.xb","Location":"ap-southeast-1"}	Bir OSS paketinde nesne olarak depolanan tam yedekleme dosyasına ilişkin bilgileri içeren JSON dizisi. Örnek: `{"Bucket":"test", "Object":"test/test_db_employees.xb","Location":"ap-southeast-1"}` Dizide aşağıdaki parametreler kullanılır: Bucket: Tam yedekleme dosyasının nesne olarak depolandığı OSS paketinin adı. Bir OSS paketinde depolanan tüm nesnelere ilişkin bilgileri sorgulamak için GetBucket işlemini çağırabilirsiniz. Object: Bir OSS paketinde nesne olarak depolanan tam yedekleme dosyasının yolu. Bir OSS paketindeki tüm yollara ilişkin bilgileri sorgulamak için GetObject işlemini çağırabilirsiniz. Location: OSS paketinin bulunduğu bölgenin kimliği. Bir OSS paketinin bölgesini sorgulamak için GetBucketLocation işlemini çağırabilirsiniz.
BucketRegion	String	Evet	cn-hangzhou	Tam yedekleme dosyasının bulunduğu OSS paketinin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
EngineVersion	String	Evet	5.7	Kendi MySQL veritabanınızda ve ApsaraDB RDS for MySQL örneğinde çalışan veritabanı altyapısının sürümü. Değer 5.7 olarak ayarlanmalıdır.
RegionId	String	Evet	cn-hangzhou	ApsaraDB RDS for MySQL örneğinin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. Not Bu parametrenin değeri, bir ApsaraDB RDS for MySQL örneği oluşturmak istediğiniz bölgenin kimliğidir. Bu parametrenin değeri, BucketRegion parametresinin değeriyle tutarlı olmalıdır.
Comment	String	Hayır	BackupTest	Tam yedekleme dosyasının açıklaması.
RestoreSize	Integer	Hayır	20	Tam yedekleme dosyasındaki verileri geri yüklemek için gereken depolama alanının boyutu. Birim: GB. Not Bu parametrenin varsayılan değeri, tam yedekleme dosyası boyutunun 5 katıdır. Bu parametrenin minimum değeri 20'dir.
Retention	Integer	Hayır	30	Tam yedekleme dosyasının saklama süresi. Birim: gün. Geçerli değerler: sıfır olmayan herhangi bir pozitif tamsayı.
ZoneId	String	Hayır	cn-hangzhou-b	ApsaraDB RDS for MySQL örneğinin alan kimliği. Alan kimliklerini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. Not Bu parametreyi belirtirseniz sistem tek basamaklı saniye cinsinden bir anlık görüntü oluşturur; bu durum tam yedekleme dosyasının içe aktarılması için gereken süreyi büyük ölçüde azaltır. Tam yedekleme dosyasını kullanarak bir ApsaraDB RDS for MySQL örneği oluşturmak üzere CreateDBInstance işlemini çağırdığınızda yeni ApsaraDB RDS for MySQL örneği bu parametrede belirttiğiniz alanda oluşturulur.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
BackupId	String	b-n8tpg24c6i0v****	Tam yedekleme dosyasının kimliği.
RequestId	String	A140DD14-DCC9-4548-9C72-52A49A58A310	İsteğin kimliği.
Status	Boolean	true	Tam yedekleme dosyasının ApsaraDB RDS for MySQL örneğine başarıyla aktarıldığını gösterir. Dosya aktarıldıysa true döndürülür. Aksi takdirde bir hata mesajı döndürülür.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=ImportUserBackupFile
&BackupFile={"Bucket":"test", "Object":"test/test_db_employees.xb","Location":"ap-southeast-1"}
&BucketRegion=cn-hangzhou
&EngineVersion=5.7
&RegionId=cn-hangzhou
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

<ImportUserBackupFileResponse>
      <RequestId>A140DD14-DCC9-4548-9C72-52A49A58A310</RequestId>
      <BackupId>b-n8tpg24c6i0v********</BackupId>
      <Status>true</Status>
</ImportUserBackupFileResponse>

JSON biçimi

{
    "RequestId":"A140DD14-DCC9-4548-9C72-52A49A58A310",
    "BackupId":"b-n8tpg24c6i0v********",
    "Status":"true"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidOssBackupFile.InvalidFile	Belirtilen OSS yedekleme dosyası geçersiz.	Belirtilen tam yedekleme dosyasının belirtilen OSS paketinde bulunamaması nedeniyle döndürülen hata mesajı.
400	OperationDenied.Product	Ürün kodu desteklenmiyor.	Ürün kodunun desteklenmemesi nedeniyle döndürülen hata mesajı.

Hata kodlarının listesi için API Hata Merkezi sayfasını ziyaret edin.