sp_columns (języka Transact-SQL)

Zwraca informacje o kolumna dla określonych tabel lub widoków, które można wyszukiwać w bieżącym środowisku.

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

Składnia

sp_columns [ @table_name = ] object  [ , [ @table_owner = ] owner ] 
     [ , [ @table_qualifier = ] qualifier ] 
     [ , [ @column_name = ] column ] 
     [ , [ @ODBCVer = ] ODBCVer ]

Argumenty

  • [ @table_name=] object
    Jest nazwą tabela lub widoku, który jest używany do zwracania informacji wykazu.object_namejest nvarchar(384), z braku domyślne.Dopasowanie do wzorca symboli wieloznacznych jest obsługiwany.

  • [ @ table_owner=] owner
    Jest właścicielem obiektu tabela lub widoku, który jest używany do zwracania informacji wykazu.ownerjest nvarchar(384), domyślna wartość NULL.Dopasowanie do wzorca symboli wieloznacznych jest obsługiwany.Jeśli owner nie jest określony, zastosowanie zasady widoczność domyślną tabela lub widok z odpowiedniego DBMS .

    Jeżeli bieżący użytkownik jest właścicielem tabela lub widoku o określonej nazwie, zwracane są kolumny tabela .Jeśli owner nie jest określony i bieżący użytkownik nie jest właścicielem tabela lub widoku o określonym object, sp_columns wyszukuje w tabela lub widoku o określonym object własnością właściciela bazy danych.Jeśli taka istnieje tabelakolumny są zwracane.

  • [ @ table_qualifier=] qualifier
    Jest to nazwa tabela lub widoku kwalifikator.qualifierjest sysname, domyślna wartość NULL.Różne produkty DBMS obsługuje trzy części nazw tabel (qualifier**.owner.**name).W SQL Server, to kolumna reprezentuje nazwę bazy danych.W przypadku niektórych produktów reprezentuje nazwa serwera środowisku tabelabazy danych.

  • [ @column_name=] column
    Jest pojedyncza kolumna i jest używany podczas chciał tylko jedną kolumna informacji o katalogu.columnjest nvarchar(384), domyślna wartość NULL.Jeśli column jest nie jest określony, wszystkie kolumny są zwracane.W SQL Server, column reprezentuje nazwę kolumna w syscolumns tabela.Dopasowanie do wzorca symboli wieloznacznych jest obsługiwany.Maksymalna interoperacyjności bramy klient powinien założyć tylko SQL-92 standardowego dopasowania (% i _ znakami wieloznacznymi).

  • [ @ODBCVer= ] ODBCVer
    Jest to wersja ODBC, który jest używany.ODBCVerjest int, domyślna wartość 2.Wskazuje ODBC w wersji 2.Prawidłowe wartości to 2 lub 3.Dla zachowania różnice w wersji 2 i 3, zobacz Microsoft ODBC SQLColumns specyfikacji.

Wartości kodów powrotnych

Brak

Zestawy wyników

Sp_columns katalog procedura składowana jest równoznaczne z SQLColumns w ODBC.wyniki zwracane są uporządkowane według TABLE_QUALIFIER, TABLE_OWNER, i nazwa_tabeli.

Nazwa kolumny

Typ danych

Opis

TABLE_QUALIFIER

sysname

Nazwa kwalifikator tabeli lub widoku.To pole może być NULL.

TABLE_OWNER

sysname

Nazwa właściciela tabeli lub widoku.To pole zawsze zwraca wartość.

NAZWA_TABELI

sysname

Nazwa tabeli lub widoku.To pole zawsze zwraca wartość.

COLUMN_NAME

sysname

Nazwa kolumny dla każdej kolumna nazwa_tabeli zwracane.To pole zawsze zwraca wartość.

DATA_TYPE

smallint

Kod całkowitą dla typu danych ODBC.Jeśli jest to typ danych, który nie może być mapowane do typu ODBC, jest NULL.Nazwa typu danych w trybie macierzystym jest zwracany w TYPE_NAME kolumna.

TYPE_NAME

sysname

Ciąg reprezentujący typ danych.Odpowiedniego DBMS przedstawia to nazwa typu danych.

PRECISION

int

Liczba znaczących cyfr.Wartość zwracana dla PRECISION kolumna jest o podstawie 10.

DŁUGOŚĆ

int

Rozmiar danych transferu.1

SKALA

smallint

Liczba cyfr po prawej stronie przecinka dziesiętnego.

PODSTAWA

smallint

Baza dla typów numerycznych.

NULLABLE

smallint

Określa opcje dopuszczania wartości null.

1 = NULL jest możliwe.

0 = NIE JEST NULL.

UWAGI

varchar(254)

To pole zawsze zwraca wartość NULL.

COLUMN_DEF

nvarchar(4000)

Wartość domyślna kolumna.

SQL Server 2008i SQL Server 2005 różnią się od SQL Server 2000 w sposób dekodowania i przechowuje wyrażenia SQL w katalogu metadane.semantyka zdekodowana wyrażenie są równoważne z oryginalnego tekstu; są jednak żadnych gwarancji składni.Na przykład spacji są usuwane z zdekodowana wyrażenie.Aby uzyskać więcej informacji zobacz temat, Zachowanie zmienia funkcje aparatu bazy danych programu SQL Server 2008 R2.

SQL_DATA_TYPE

smallint

Wartość typu danych SQL , wyświetlaną w polu Typ pole deskryptora.W tej kolumna jest taka sama, jak DATA_TYPE kolumna, z wyjątkiem datetime SQL-92 i Interwał typów danych.W tej kolumna zawsze zwraca wartość.

SQL_DATETIME_SUB

smallint

Kod dla podtypu datetime SQL-92 i Interwał typów danych.W przypadku innych typów danych w tej kolumna zwraca wartość NULL.

CHAR_OCTET_LENGTH

int

Maksymalna długość bajtów danych znak lub całkowitą wpisz kolumna.W przypadku innych typów danych w tej kolumna zwraca wartość NULL.

ORDINAL_POSITION

int

Pozycja porządkowa kolumna w tabela.Pierwsza kolumna w tabela wynosi 1.W tej kolumna zawsze zwraca wartość.

IS_NULLABLE

varchar(254)

Nullability kolumna w tabela.Regułami ISO są stosowane do określenia opcje dopuszczania wartości null.ISO SQL-zgodnych z DBMS nie zwraca pusty ciąg.

TAK = kolumna może zawierać wartości null.

NIE = kolumna nie może zawierać wartości null.

W tej kolumna zwraca ciąg o zerowej długości, jeśli opcje dopuszczania wartości null jest nieznany.

Wartość zwracana dla tej kolumna jest inna niż wartość zwracana w przypadku NULLABLE kolumna.

SS_DATA_TYPE

tinyint

SQL ServerTyp danych używany przez rozszerzonych procedur przechowywanych.Aby uzyskać więcej informacji, zobacz Typy danych (Transact-SQL).

1 Więcej informacji na ten temat można znaleźć w dokumentacji Microsoft ODBC.

Uprawnienia

Wymaga uprawnienie SELECT schematu.

Uwagi

sp_columns następujące wymagania dotyczące identyfikatorów rozdzielany.Aby uzyskać więcej informacji, zobacz Identyfikatory rozdzielanego (aparat bazy danych).

Przykłady

Poniższy przykład zwraca informacje o kolumna dla określonej tabela.

USE AdventureWorks2008R2;
GO
EXEC sp_columns @table_name = N'Department',
   @table_owner = N'HumanResources';