Co to jest typ danych SYSNAME w programie SQL Server?

Do czego służy typ danych SYSNAME programu SQL Server? BOL mówi:

Typ danych sysname jest używany dla kolumn tabeli, zmiennych i parametrów procedur składowanych, które przechowują nazwy obiektów.

ale tak naprawdę tego nie rozumiem. Czy możesz podać przykład użycia?

sysnameto wbudowany typ danych ograniczony do 128 znaków Unicode, który, IIRC, jest używany głównie do przechowywania nazw obiektów podczas tworzenia skryptów. Jego wartość nie może byćNULL

Zasadniczo jest to to samo, co używanie nvarchar(128) NOT NULL

EDYTOWAĆ

Jak wspomniał @Jim w komentarzach, nie sądzę, aby istniał przypadek biznesowy, w którym chciałbyś sysnamebyć szczery. Jest używany głównie przez firmę Microsoft podczas tworzenia wewnętrznych systabel i procedur składowanych itp. W programie SQL Server.

Na przykład, wykonując polecenie Exec sp_help 'sys.tables', zobaczysz, że kolumna namejest zdefiniowana w sysnameten sposób, ponieważ wartość this jest w rzeczywistości obiektem samym w sobie (tabelą)

Za bardzo bym się tym martwił.

Warto również zauważyć, że dla tych osób, które nadal używają SQL Server 6.5 i niższych (czy nadal są ludzie używający?), Typ wbudowany sysnamejest odpowiednikiemvarchar(30)

Dokumentacja

sysnamejest zdefiniowany w dokumentacji dla ncharinvarchar , w sekcji uwag:

sysname jest typem danych zdefiniowanym przez użytkownika, który jest funkcjonalnie równoważny z nvarchar (128) , z tą różnicą, że nie dopuszcza wartości null. sysname służy do odwoływania się do nazw obiektów bazy danych.

Aby wyjaśnić powyższe uwagi, domyślnie zdefiniowano nazwę sysname, ponieważ z NOT NULLpewnością można zdefiniować ją jako dopuszczającą wartość null. Należy również zauważyć, że dokładna definicja może się różnić w zależności od wystąpienia programu SQL Server.

Korzystanie ze specjalnych typów danych

Sysname typ danych jest używany dla kolumn tabeli, zmienne i parametry przechowywane procedury, która przechowywanie nazw obiektów. Dokładna definicja sysname jest związana z regułami dotyczącymi identyfikatorów. Dlatego może się różnić między wystąpieniami programu SQL Server. sysname jest funkcjonalnie takie samo jak nvarchar (128), z tym wyjątkiem, że domyślnie sysname NIE ma wartości NULL. We wcześniejszych wersjach SQL Server nazwa sys jest definiowana jako varchar (30).

Dodatkowe informacje na temat sysnamedopuszczania lub blokowania NULLwartości można znaleźć tutaj https://stackoverflow.com/a/52290792/300863

Tylko dlatego, że jest to wartość domyślna (NIE NULL), nie gwarantuje, że tak będzie!

Czy możesz podać przypadek użycia?

Jeśli kiedykolwiek zajdzie potrzeba utworzenia jakiegoś dynamicznego sql , należy użyć go sysnamejako typu danych dla zmiennych przechowujących nazwy tabel, nazw kolumn i nazw serwerów.

Tak jak FYI ....

select * from sys.types where system_type_id = 231 daje dwa rzędy.

(Nie jestem jeszcze pewien, co to oznacza, ale jestem w 100% pewien, że teraz psuje mój kod)

edit: domyślam się, że oznacza to, że w tej sytuacji powinieneś dołączyć za pomocą user_type_id (moja sytuacja) lub prawdopodobnie zarówno user_type_id, jak i system_type_id

name        system_type_id   user_type_id   schema_id   principal_id    max_length  precision   scale   collation_name                  is_nullable     is_user_defined     is_assembly_type    default_object_id   rule_object_id
nvarchar    231              231            4           NULL            8000        0           0       SQL_Latin1_General_CP1_CI_AS    1               0                   0                   0                   0
sysname     231              256            4           NULL            256         0           0       SQL_Latin1_General_CP1_CI_AS    0               0                   0                   0                   0

create procedure dbo.yyy_test (
    @col_one    nvarchar(max),
    @col_two    nvarchar(max)  = 'default',
    @col_three  nvarchar(1),
    @col_four   nvarchar(1)    = 'default',
    @col_five   nvarchar(128),
    @col_six    nvarchar(128)  = 'default',
    @col_seven  sysname  
)
as begin 

    select 1
end 

To zapytanie:

select  parm.name AS Parameter,    
        parm.max_length, 
        parm.parameter_id 
         
from    sys.procedures sp

        join sys.parameters parm ON sp.object_id = parm.object_id 
        
where   sp.name = 'yyy_test'

order   by parm.parameter_id

Plony:

parameter           max_length  parameter_id
@col_one            -1          1
@col_two            -1          2
@col_three           2          3
@col_four            2          4
@col_five            256        5
@col_six             256        6
@col_seven           256        7

I to:

select  parm.name as parameter,    
        parm.max_length, 
        parm.parameter_id,
        typ.name as data_type, 
        typ.system_type_id, 
        typ.user_type_id,
        typ.collation_name,
        typ.is_nullable 
from    sys.procedures sp

        join sys.parameters parm ON sp.object_id = parm.object_id
        
        join sys.types typ ON parm.system_type_id = typ.system_type_id
        
where   sp.name = 'yyy_test'

order   by parm.parameter_id

Daje ci to:

parameter   max_length  parameter_id    data_type   system_type_id  user_type_id    collation_name                  is_nullable
@col_one    -1          1               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_one    -1          1               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0
@col_two    -1          2               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_two    -1          2               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0
@col_three   2          3               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_three   2          3               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0
@col_four    2          4               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_four    2          4               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0
@col_five    256        5               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_five    256        5               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0
@col_six     256        6               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_six     256        6               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0
@col_seven   256        7               nvarchar    231             231             SQL_Latin1_General_CP1_CI_AS    1
@col_seven   256        7               sysname     231             256             SQL_Latin1_General_CP1_CI_AS    0

Poniżej wymienię przypadek użycia. Mam nadzieję, że to pomoże. Tutaj próbuję znaleźć właściciela tabeli „Stud_dtls” z DB „Students”. Jak wspomniał Mikael, nazwa sysname może być używana, gdy istnieje potrzeba stworzenia jakiegoś dynamicznego sql, który wymaga zmiennych przechowujących nazwy tabel, nazw kolumn i nazw serwerów. Pomyślałem o podaniu prostego przykładu, który uzupełni jego punkt widzenia.

USE Students

DECLARE @TABLE_NAME sysname

SELECT @TABLE_NAME = 'Stud_dtls'

SELECT TABLE_SCHEMA 
  FROM INFORMATION_SCHEMA.Tables
 WHERE TABLE_NAME = @TABLE_NAME

sysnamejest używany przez sp_send_dbmailprocedurę składowaną, która „Wysyła wiadomość e-mail do określonych odbiorców” i znajduje się w bazie danych msdb.

Według Microsoftu ,

[ @profile_name = ] 'profile_name'  

To nazwa profilu, z którego chcesz wysłać wiadomość. Nazwa_profilu jest typu nazwa_systemu, z domyślną wartością NULL. Nazwa_profilu musi być nazwą istniejącego profilu poczty bazy danych. Jeśli nazwa_profilu nie jest określona, ​​sp_send_dbmail używa domyślnego profilu prywatnego dla bieżącego użytkownika. Jeśli użytkownik nie ma domyślnego profilu prywatnego, sp_send_dbmail używa domyślnego profilu publicznego dla bazy danych msdb. Jeśli użytkownik nie ma domyślnego profilu prywatnego i nie ma domyślnego profilu publicznego dla bazy danych, należy określić @profile_name.

FWIW, możesz przekazać nazwę tabeli do przydatnych SP systemowych w ten sposób, jeśli chcesz eksplorować bazę danych w ten sposób:

DECLARE @Table sysname; SET @Table = 'TableName';
EXEC sp_fkeys @Table;
EXEC sp_help @Table;

Innym przypadkiem użycia jest korzystanie z funkcji programu SQL Server 2016+ AT TIME ZONE

Poniższa instrukcja zwróci datę przekonwertowaną na GMT

SELECT 
CONVERT(DATETIME, SWITCHOFFSET([ColumnA], DATEPART(TZOFFSET, [ColumnA] AT TIME ZONE 'GMT Standard Time')))

Jeśli chcesz przekazać strefę czasową jako zmienną, powiedz:

SELECT 
CONVERT(DATETIME, SWITCHOFFSET([ColumnA], DATEPART(TZOFFSET, [ColumnA] AT TIME ZONE @TimeZone)))

wtedy ta zmienna musi być tego typu sysname(zadeklarowanie jej jako varcharspowoduje błąd).

Czy możesz podać przypadek użycia?

Wszędzie tam, gdzie chcesz przechowywać nazwę obiektu do użytku przez skrypty konserwacji bazy danych. Na przykład skrypt usuwa stare wiersze z niektórych tabel, które mają kolumnę daty. Jest skonfigurowany z tabelą, która zawiera nazwę tabeli, nazwę kolumny do filtrowania i liczbę dni historii do zachowania. Inny skrypt zrzuca określone tabele do plików CSV i ponownie jest skonfigurowany z tabelą zawierającą tabele do zrzucenia. Te tabele konfiguracji mogą używać sysnametypu do przechowywania nazw tabel i kolumn.