Bagikan melalui

sp_syscollector_update_collection_set (T-SQL)

  • Artikel

Berlaku untuk: SQL Server

Digunakan untuk mengubah properti kumpulan yang ditentukan pengguna atau untuk mengganti nama kumpulan koleksi yang ditentukan pengguna.

Peringatan

Dalam kasus di mana akun Windows yang dikonfigurasi sebagai proksi adalah pengguna non-interaktif atau interaktif yang belum masuk, direktori profil tidak akan ada, dan pembuatan direktori penahapan akan gagal. Oleh karena itu, jika Anda menggunakan akun proksi pada pengendali domain, Anda harus menentukan akun interaktif yang telah digunakan setidaknya sekali untuk memastikan bahwa direktori profil telah dibuat.

Konvensi sintaks transact-SQL

Sintaks

sp_syscollector_update_collection_set
    [ [ @collection_set_id = ] collection_set_id ]
    [ , [ @name = ] N'name' ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @target = ] N'target' ]
    [ , [ @collection_mode = ] collection_mode ]
    [ , [ @days_until_expiration = ] days_until_expiration ]
    [ , [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @schedule_uid = ] 'schedule_uid' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @logging_level = ] logging_level ]
    [ , [ @description = ] N'description' ]
[ ; ]

Argumen

[ @collection_set_id = ] collection_set_id

Pengidentifikasi lokal unik untuk kumpulan koleksi. @collection_set_id int, dan harus memiliki nilai jika @name adalah NULL.

[ @name = ] N'name'

Nama kumpulan koleksi. @name adalah sysname, dan harus memiliki nilai jika @collection_set_id adalah NULL.

[ @new_name = ] N'new_name'

Nama baru untuk kumpulan koleksi. @new_name adalah sysname, dengan default NULL, dan jika digunakan, tidak boleh berupa string kosong. @new_name harus unik. Untuk daftar nama kumpulan koleksi saat ini, kueri syscollector_collection_sets tampilan sistem.

[ @target = ] N'target'

Disiapkan untuk penggunaan masa mendatang. @target adalah nvarchar(128), dengan default NULL.

[ @collection_mode = ] collection_mode

Jenis pengumpulan data yang akan digunakan. @collection_mode kecil, dan dapat memiliki salah satu nilai berikut:

  • 0: Mode singgahan. Pengumpulan dan pengunggahan data berada pada jadwal terpisah. Tentukan mode singgahan untuk koleksi berkelanjutan.

  • 1: Mode non-cache. Pengumpulan dan pengunggahan data berada pada jadwal yang sama. Tentukan mode non-cache untuk koleksi ad hoc atau koleksi rekam jepret.

Jika mengubah dari mode non-cache ke mode cache (0), Anda juga harus menentukan @schedule_uid atau @schedule_name.

[ @days_until_expiration = ] days_until_expiration

Jumlah hari data yang dikumpulkan disimpan di gudang data manajemen. @days_until_expiration kecil, dan harus 0 atau bilangan bulat positif.

[ @proxy_id = ] proxy_id

Pengidentifikasi unik untuk akun proksi SQL Server Agent. @proxy_id int.

[ @proxy_name = ] N'proxy_name'

Nama proksi. @proxy_name adalah sysname, dengan default NULL.

[ @schedule_uid = ] 'schedule_uid'

GUID yang menunjuk ke jadwal. @schedule_uid adalah uniqueidentifier, dengan default NULL.

Untuk mendapatkan @schedule_uid, kueri sysschedules tabel sistem.

Ketika @collection_mode diatur ke 0, @schedule_uid atau @schedule_name harus ditentukan. Ketika @collection_mode diatur ke 1, @schedule_uid atau @schedule_name diabaikan jika ditentukan.

[ @schedule_name = ] N'schedule_name'

Nama jadwal. @schedule_name adalah sysname, dengan default NULL. Jika ditentukan, @schedule_uid harus NULL. Untuk mendapatkan @schedule_name, kueri sysschedules tabel sistem.

[ @logging_level = ] logging_level

Tingkat pengelogan. @logging_level kecil, dengan default 1, dengan salah satu nilai berikut:

  • 0: Catat informasi eksekusi dan peristiwa SSIS yang melacak:

    • Memulai/menghentikan kumpulan koleksi
    • Memulai/menghentikan paket
    • Informasi kesalahan

  • 1: Pengelogan tingkat 0 dan:

    • Statistik eksekusi
    • Kemajuan pengumpulan yang terus berjalan
    • Peristiwa peringatan dari SSIS

  • 2: Pengelogan tingkat-1 dan informasi peristiwa terperinci dari SSIS.

[ @description = ] N'description'

Deskripsi kumpulan koleksi. @description adalah nvarchar(4000), dengan default NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_syscollector_update_collection_set harus dijalankan dalam konteks msdb database sistem.

Baik collection_set_id atau nama harus memiliki nilai, keduanya tidak boleh NULL. Untuk mendapatkan nilai-nilai ini, kueri syscollector_collection_sets tampilan sistem.

Jika kumpulan berjalan, Anda hanya dapat memperbarui schedule_uid dan deskripsi. Untuk menghentikan kumpulan koleksi, gunakan sp_syscollector_stop_collection_set.

Izin

Memerlukan keanggotaan dalam peran database tetap dc_admin atau dc_operator (dengan izin EXECUTE) untuk menjalankan prosedur ini. Meskipun dc_operator dapat menjalankan prosedur tersimpan ini, anggota peran ini terbatas pada properti yang dapat mereka ubah. Properti berikut ini hanya dapat diubah dengan dc_admin:

  • @new_name
  • @target
  • @proxy_id
  • @description
  • @collection_mode
  • @days_until_expiration

Contoh

J. Mengganti nama kumpulan koleksi

Contoh berikut mengganti nama kumpulan koleksi yang ditentukan pengguna.

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO

B. Mengubah mode koleksi dari yang tidak di-cache menjadi di-cache

Contoh berikut mengubah mode koleksi dari mode non-cache ke mode cache. Perubahan ini mengharuskan Anda menentukan ID jadwal atau nama jadwal.

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO

C. Mengubah parameter kumpulan koleksi lainnya

Contoh berikut memperbarui berbagai properti kumpulan koleksi bernama Simple collection set test 2.

USE msdb;
GO

EXEC dbo.sp_syscollector_update_collection_set
    @name = N'Simple collection set test 2',
    @collection_mode = 1,
    @days_until_expiration = 5,
    @description = N'This is a test collection set that runs in noncached mode.',
    @logging_level = 0;
GO

Konten terkait