Udostępnij przez


Core.sp_create_snapshot (języka Transact-SQL)

Wstawia wiersz w zarządzanie magazyn danych core.snapshots Widok.Procedura ta nosi nazwę każdego czas przekazywania pakiet uruchomi przekazywania danych do zarządzania magazyn danych.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

core.sp_create_snapshot [ @collection_set_uid = ] 'collection_set_uid'
    , [ @collector_type_uid = ] 'collector_type_uid'
    ,[ @machine_name = ] 'machine_name'
    , [ @named_instance = ] 'named_instance'
    , [ @log_id = ] log_id
    , [ @snapshot_id = ] snapshot_id OUTPUT

Argumenty

  • [ @ collection_set_uid = ] 'collection_set_uid"
    Identyfikator GUID dla kolekcja zestaw.collection_set_uid jest uniqueidentifier z braku wartości domyślnej.Aby uzyskać identyfikator GUID, kwerenda dbo.syscollector_collection_sets przeglądać w msdb bazy danych.

  • [ @ collector_type_uid = ] 'collector_type_uid"
    Identyfikator GUID typ modułu zbierającego.collector_type_uidjest uniqueidentifier z braku wartości domyślnej.Aby uzyskać identyfikator GUID, kwerenda dbo.syscollector_collector_types przeglądać w msdb bazy danych.

  • [ @machine_name= ] 'machine_name'
    Nazwa serwera, kolekcja zestaw znajdujący się na.machine_namejest sysname, z braku wartości domyślnej.

  • [ @ named_instance= ] 'named_instance"
    Nazwa wystąpienie kolekcja zestaw.named_instancejest sysname, z braku wartości domyślnej.

  • [ @log_id = ] log_id
    Identyfikator unikatowy, że mapy izestaw kolekcjazdarzenie logowania na serwerze, który pobiera dane. log_idjest bigint z braku wartości domyślnej.Aby uzyskać wartości dla log_id, kwerenda dbo.syscollector_execution_log wyświetlić w msdb bazy danych.

  • [ @ snapshot_id = ] snapshot_id
    Identyfikator unikatowy wiersza, który jest wstawiany do core.snapshots Widok.snapshot_idjest int i jest zwracany w danych wyjściowych.

Wartości kodów powrotnych

0(sukces) lub 1 (błąd)

Uwagi

Każdy czas przekazywania pakiet wywołuje danych zbierających Uruchom - składnikczas uruchamiania przekazywania danych do zarządzania magazyn danych core.sp_create_snapshot.

Procedura ta sprawdza, czy:

  • collection_set_uid Odpowiada istniejącemu wpisowi w core.source_info_internaltabela.

  • collector_type_uid Odpowiada istniejącemu wpisowi w core.supported_collector_types Widok.

Jeśli jeden z powyższych kontroli nie powiedzie się, procedura kończy się niepowodzeniem i zwraca błąd.

Uprawnienia

Wymaga członkostwa w mdw_writer (z uprawnieniem Wykonywanie) ustalony rola bazy danych.

Przykłady

Poniższy przykład tworzy migawka dla kolekcjawykorzystanie dysku,zestaw, dodaje do zarządzania magazyn danychi zwraca identyfikator migawka . W przykładzie używana jest wystąpienie domyślne .

USE <management_data_warehouse>;
DECLARE @snapshot_id int;
EXEC core.sp_create_snapshot 
    @collection_set_uid = '7B191952-8ECF-4E12-AEB2-EF646EF79FEF', 
    @collector_type_uid = '302E93D1-3424-4BE7-AA8E-84813ECF2419',
    @machine_name = '<computername>',
    @named_instance = 'MSSQLSERVER',
    @log_id = 11, -- ID of the log for the collection set
    @snapshot_id = @snapshot_id OUTPUT;