Bagian ini menjelaskan prosedur yang tersimpan untuk instance Cloud SQL.
Prosedur tersimpan berisi kode SQL yang dapat Anda gunakan kembali.
Untuk menjalankan prosedur yang tersimpan, gunakan perintah EXEC
dan ganti
variabel berikut:
- procedure_name adalah nama prosedur yang disimpan.
- database_name adalah nama database tempat Anda ingin menjalankan prosedurnya.
- schema_name adalah nama skema tempat Anda ingin menjalankan prosedurnya.
EXEC database_name.schema_name.procedure_name @param1, @param2;Untuk mengetahui informasi selengkapnya, lihat halaman referensi EXECUTE (Transact-SQL).
Untuk membuat prosedur tersimpan Anda sendiri, lihat Membuat Prosedur Tersimpan.
Prosedur tersimpan Cloud SQL untuk SQL Server
Prosedur tersimpan untuk penggunaan penyisipan massal
Untuk informasi tentang penyisipan massal, lihat Menggunakan penyisipan massal untuk mengimpor data.
msdb.dbo.gcloudsql_bulk_insert
Sintaks
EXEC msdb.dbo.gcloudsql_bulk_insert @database @schema @object @file ...
Deskripsi
Prosedur yang tersimpan ini memiliki parameter dan perilaku yang mirip dengan perintah BULK INSERT.
Prosedur yang disimpan mengimpor data ke instance Cloud SQL dari file yang disimpan di bucket Cloud Storage. WPA ini menggunakan Cloud Storage interoperabilitas API dan kunci HMAC untuk mengautentikasi akses ke bucket Cloud Storage.
Prosedur tersimpan ini memiliki parameter berikut:
Parameter | Jenis | Deskripsi |
---|---|---|
@database |
SYSNAME |
Menentukan nama database target tempat data akan diimpor. |
@schema |
SYSNAME |
Menentukan nama skema yang memiliki tabel. |
@object |
NVARCHAR |
Menentukan nama tabel tempat data akan disisipkan. |
@file |
NVARCHAR |
Menentukan jalur ke file impor di bucket Cloud Storage.
Jalur tersebut harus memiliki format berikut: s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH Ganti kode berikut:
|
@batchsize |
INT |
Menentukan jumlah baris dalam batch. |
@checkconstraints |
BIT |
Menentukan bahwa semua batasan pada tabel target harus diperiksa. |
@codepage |
NVARCHAR |
Menentukan halaman kode untuk data dalam file.
RAW adalah opsi default dan satu-satunya. |
@datafiletype |
NVARCHAR |
Menentukan jenis file penyisipan massal. |
@datasource |
NVARCHAR |
Menentukan nama sumber data eksternal tempat Anda ingin mengimpor data. |
@errorfile |
NVARCHAR |
Menentukan jalur ke file yang digunakan untuk mengumpulkan baris yang memiliki error format.
Jalur tersebut harus memiliki format berikut: s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH Ganti kode berikut:
Selain itu, Cloud SQL membuat file dengan ekstensi
|
@errorfiledatasource |
NVARCHAR |
Menentukan nama sumber data eksternal tempat Anda ingin membuat file error. |
@firstrow |
INT |
Menentukan ID numerik baris pertama yang akan dimuat. |
@firetriggers |
BIT |
Menunjukkan bahwa setiap pemicu penyisipan yang ditentukan pada tabel target akan dijalankan selama operasi penyisipan massal. |
@formatfiledatasource |
NVARCHAR |
Menentukan nama sumber data eksternal tempat Anda harus memuat file format. |
@keepidentity |
BIT |
Menentukan penggunaan data identitas dari file impor untuk kolom identitas. Nilainya adalah 0 , yang berarti salah, dan 1 , yang berarti benar. |
@keepnulls |
BIT |
Menentukan apakah kolom kosong harus mempertahankan nilai null selama operasi impor massal, bukan memiliki nilai default untuk kolom yang disisipkan. Nilainya adalah 0 , yang berarti salah, dan 1 , yang berarti benar. |
@kilobytesperbatch |
INT |
Menentukan jumlah data per batch, dalam KB. |
@lastrow |
INT |
Menentukan ID numerik baris terakhir yang akan dimuat. |
@maxerrors |
INT |
Menentukan jumlah error yang diizinkan, sebelum Cloud SQL membatalkan operasi. |
@ordercolumnsjson |
NVARCHAR |
Menentukan tata urutan dan kolom, dalam format JSON. Contoh:
[{"name": "COLUMN_NAME","order": "ORDER"},{"name": "COLUMN_NAME","order": "ORDER"}] Ganti kode berikut:
|
@rowsperbatch |
INT |
Menentukan jumlah baris per batch.
Untuk informasi selengkapnya tentang memilih ukuran tumpukan, lihat Pertimbangan performa |
@tablock |
BIT |
Menentukan bahwa penguncian tabel diambil selama durasi operasi penyisipan massal. |
@format |
NVARCHAR |
Menentukan format file. Gunakan CSV sebagai nilai parameter ini. |
@fieldquote |
NVARCHAR |
Menentukan karakter yang akan digunakan sebagai karakter kutipan dalam file CSV.
Jika Anda tidak menentukan nilai, Cloud SQL akan menggunakan |
@formatfile |
NVARCHAR |
Menentukan jalur file dalam Cloud Storage yang menjelaskan format data yang akan diimpor.
Jalur tersebut harus memiliki format berikut: s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH Ganti kode berikut:
|
@fieldterminator |
NVARCHAR |
Menentukan terminator kolom untuk file data karakter dan widechar. |
@rowterminator |
NVARCHAR |
Menentukan terminator baris untuk file data char dan widechar. |
Prosedur tersimpan untuk fungsi Audit Server SQL
Untuk mengetahui informasi tentang penggunaan fungsi Audit SQL Server, lihat Audit database SQL Server.
msdb.dbo.gcloudsql_fn_get_audit_file
Sintaks
msdb.dbo.gcloudsql_fn_get_audit_file
Deskripsi
Mengambil data dari file audit yang dibuat oleh fungsi Audit SQL Server.
Prosedur tersimpan ini menerima parameter yang sama dengan fungsi sys.fn_get_audit_file
. Lihat dokumentasi fungsi tersebut untuk informasi selengkapnya terkait msdb.dbo.gcloudsql_fn_get_audit_file
.
Prosedur tersimpan untuk pengambilan data perubahan (CDC)
Untuk informasi selengkapnya tentang CDC, lihat Mengaktifkan perubahan pengambilan data.
msdb.dbo.gcloudsql_cdc_enable_db
Sintaks
exec msdb.dbo.gcloudsql_cdc_enable_db databaseName
Deskripsi
Mengaktifkan pengambilan data perubahan untuk database.
databaseName
- Nama database untuk menjalankan prosedur tersimpan ini.
msdb.dbo.gcloudsql_cdc_disable_db
Sintaks
exec msdb.dbo.gcloudsql_cdc_disable_db databaseName
Deskripsi
Menonaktifkan CDC untuk database.
databaseName
- Nama database untuk menjalankan prosedur tersimpan ini.
Prosedur tersimpan untuk replikasi eksternal dengan Cloud SQL sebagai penayang
Untuk mengetahui informasi selengkapnya tentang cara memublikasikan ke subscriber eksternal, atau ke instance Cloud SQL lainnya, lihat Mengonfigurasi replika eksternal.
msdb.dbo.gcloudsql_transrepl_setup_distribution
Sintaks
exec msdb.dbo.gcloudsql_transrepl_setup_distribution @login,@password
Deskripsi
Prosedur tersimpan wrapper yang menyiapkan database distribusi. Wrapper akan memanggil hal berikut: sp_adddistributor, sp_adddistributiondb, dan sp_adddistpublisher.
- login - Login yang ada yang digunakan untuk menghubungkan dan membuat database distribusi.
- sandi - Sandi yang digunakan saat menghubungkan ke distributor.
msdb.dbo.gcloudsql_transrepl_replicationdboption
Sintaks
exec msdb.dbo.gcloudsql_transrepl_replicationdboption @db,@value
Deskripsi
Mengaktifkan atau menonaktifkan opsi publikasi database untuk penayang yang menggunakan sp_replicationdboption.
- db - Database yang opsi replikasinya sedang ditetapkan.
- value - Memungkinkan Anda menentukan
True
untuk mengaktifkan opsi publikasi, atauFalse
untuk menonaktifkan opsi publikasi.
msdb.dbo.gcloudsql_transrepl_addlogreader_agent
Sintaks
exec msdb.dbo.gcloudsql_transrepl_addlogreader_agent @db,@login,@password
Deskripsi
Menyiapkan agen pembaca log untuk database yang menggunakan sp_addlogreader_agent.
- db - Database yang akan dipublikasikan.
- login - Login yang digunakan saat terhubung ke penayang.
- sandi - Sandi yang digunakan saat terhubung.
msdb.dbo.gcloudsql_transrepl_addpublication
Sintaks
exec msdb.dbo.gcloudsql_transrepl_addpublication @db,@publication
Deskripsi
Membuat publikasi transaksional, dan bertindak sebagai prosedur yang disimpan oleh wrapper untuk sp_addpublication.
- db - Database yang sedang dipublikasikan.
- publikasi - Nama publikasi baru yang dibuat.
msdb.dbo.gcloudsql_transrepl_droppublication
Sintaks
exec msdb.dbo.gcloudsql_transrepl_droppublication @db,@publication
Deskripsi
Menghapus publikasi transaksional, dan bertindak sebagai prosedur yang disimpan oleh wrapper untuk sp_droppublication.
- db - Database yang publikasinya dihapus.
- publikasi - Nama publikasi dihapus.
msdb.dbo.gcloudsql_transrepl_addpublication_snapshot
Sintaks
exec msdb.dbo.gcloudsql_transrepl_addpublication_snapshot @db,@publication,@login,@password
Deskripsi
Membuat agen snapshot untuk database yang sedang dipublikasikan, yang bertindak sebagai prosedur tersimpan wrapper untuk sp_addpublication_snapshot.
- db - Database yang publikasinya dihapus.
- publikasi - Nama publikasi dihapus.
- login - Login yang digunakan saat terhubung ke penayang.
- sandi - Sandi yang digunakan saat terhubung.
msdb.dbo.gcloudsql_transrepl_addpushsubscription_agent
Sintaks
exec msdb.dbo.gcloudsql_transrepl_addpushsubscription_agent
@db,@publication,@subscriber_db,@subscriber_login,
@subscriber_password,@subscriber
Deskripsi
Membuat tugas agen terjadwal yang baru untuk menyinkronkan langganan push, yang bertindak sebagai prosedur tersimpan wrapper untuk sp_addpushsubscription_agent.
- db - Database yang dipublikasikan.
- publikasi - Nama publikasi yang akan ditambahi agen langganan push.
- subscriber_db - Database di pelanggan.
- subscriber_login - Login yang digunakan saat terhubung ke pelanggan.
- subscriber_password - Sandi yang digunakan saat terhubung ke pelanggan.
- subscriber - Nama IP instance pelanggan. Nilai ini dapat
ditentukan sebagai:
<Hostname>,<PortNumber>
msdb.dbo.gcloudsql_transrepl_addmonitoraccess
Sintaks
exec msdb.dbo.gcloudsql_transrepl_addmonitoraccess @login
Deskripsi
Memberikan akses ke Monitor Replikasi dan pernyataan SELECT
pada
tabel terkait replikasi di database distribusi.
- login - Login yang digunakan untuk mengakses pemantauan replikasi.
msdb.dbo.gcloudsql_transrepl_changedistributor_property
Sintaks
exec msdb.dbo.gcloudsql_transrepl_changedistributor_property @property,@value
Deskripsi
Prosedur tersimpan ini mengubah heartbeat_interval
, dan
menggabungkan sp_changedistributor_property
. Untuk mengetahui informasi selengkapnya, baca
dokumentasi
untuk sp_changedistributor_property
. Lihat juga dokumentasi tersebut untuk mengetahui informasi
selengkapnya tentang nilai heartbeat_interval
.
- properti - Properti untuk database distribusi.
- nilai - Nilai yang akan diberikan untuk properti yang ditentukan.
msdb.dbo.gcloudsql_transrepl_dropsubscriber
Sintaks
exec msdb.dbo.gcloudsql_transrepl_dropsubscriber @subscriber
Deskripsi
Menghapus subscriber, yang bertindak sebagai prosedur penyimpanan wrapper untuk sp_dropsubscriber.
- subscriber - Nama IP pelanggan yang akan dihapus. Nilai ini dapat
ditentukan sebagai:
<Hostname>,<PortNumber>
msdb.dbo.gcloudsql_transrepl_remove_distribution
Sintaks
exec msdb.dbo.gcloudsql_transrepl_remove_distribution
Deskripsi
Menghapus pengaturan distribusi, yang bertindak sebagai prosedur yang disimpan wrapper untuk hal berikut: sp_dropdistpublisher, sp_dropdistributiondb, dan sp_dropdistributor.
Langkah selanjutnya
- Pelajari cara mengaktifkan pengambilan data perubahan (CDC).
- Pelajari cara mengonfigurasi replika eksternal.