Aracılığıyla paylaş

  • Makale

sp_describe_cursor_columns (Transact-SQL)

Sütunları sonuç kümesi server imleçözniteliklerini bildirir.

Konu bağlantısı simgesiTransact-SQL sözdizimi kuralları

Sözdizimi

sp_describe_cursor_columns 
   [ @cursor_return = ] output_cursor_variable OUTPUT 
    { [ , [ @cursor_source = ] N'local' , 
          [ @cursor_identity = ] N'local_cursor_name' ] 
    | [ , [ @cursor_source = ] N'global' , 
          [ @cursor_identity = ] N'global_cursor_name' ] 
    | [ , [ @cursor_source = ] N'variable' , 
          [ @cursor_identity = ] N'input_cursor_variable' ] 
   }

Bağımsız değişkenler

  • [ @cursor_return= ] output_cursor_variable OUTPUT
    imleç çıktı almak için imleç bildirilen değişken adıdır.output_cursor_variableolan cursor, hiçbir varsayılan ve gereken saattüm imleçler ile ilişkili olmaması sp_describe_cursor_columns denir.Döndürülen imleç kaydırılabilir, dinamik, salt okunur bir imleçolur.

  • [ @cursor_source= ] { N'local' | N'global' | N'variable' }
    Yerel imleç, genel imleçveya imleç değişken adını kullanarak rapor üzerinde imleç denetlenip denetlenmeyeceğini belirtir.Parametre nvarchar(30).

  • [ @cursor_identity= ] N'local_cursor_name'
    imleç ya da yerel anahtar sözcüğü olan veya yerel varsayılan olarak alınır bir BİLDİRMEK İMLEÇ deyim tarafından oluşturulan adıdır.local_cursor_nameis nvarchar(128).

  • [ @cursor_identity= ] N'global_cursor_name'
    imleç genel anahtar sözcük ya da sahip veya global için varsayılan olarak alınır bir BİLDİRMEK İMLEÇ deyim tarafından oluşturulan adıdır.global_cursor_nameis nvarchar(128).

    global_cursor_nameAyrıca odbc uygulama tarafından açılmış ve sonra çağırarak adlı bir API sunucu imleç adı olarak SQLSetCursorName.

  • [ @cursor_identity= ] N'input_cursor_variable'
    Açık imleçile ilişkili bir imleç değişken adıdır.input_cursor_variableis nvarchar(128).

Dönüş Kodu Değerleri

Hiçbiri

Döndürülen İmleçler

sp_describe_cursor_columnsalt rapor olarak Kapsüller bir Transact-SQL imleç çıkış parametresi.Böylece Transact-SQL toplu işlemleri, saklı yordamları ve Tetikleyicileri çıkış bir satır ile her saatçalışmak için.Bu da yordamı veritabanı API işlevlerini doğrudan çağrılamaz anlamına gelir.cursor Çıkış parametresi bağlı, değişkene bir program, ancak veritabanı API'leri desteklemiyor bağlama cursor parametre veya değişken.

Aşağıdaki tablo kullanarak döndürülen imleç biçimi gösterir sp_describe_cursor_columns.

Sütun adı

Veri türü

Açıklama

column_name

sysname(Null olabilecek)

Result\ küme sonuç kümesisütuniçin atanan ad. sütun bir yan tümceeşlik olmadan belirtilen sütun null olur.

ordinal_position

int

En soldaki sütun sütun göreli konumunu sonuç kümesi.İlk sütun 0 konumunda.

column_characteristics_flags

int

ole DBiçinde dbcolumnflags saklanan bilgileri gösteren bir bit maskesi.Bir tane veya aşağıdaki gibi olabilir:

1 = Yer işareti

2 = Sabit uzunluk

4 Boş'U =

8 = Satır sürüm oluşturma

16 = Güncelleştirilebilir sütun (küme hiçbir for update yan tümce vardır ve bu tür bir sütunise yalnızca imleçher bir olabilen bir imleç öngörülen sütunlar için).

Bit değerleri birleştirildiğinde, birleşik bit değerlerin uygulanır.Bit değerinin 6 Örneğin, sütun bir sabit uzunlukta (2) ise, null (4) sütun.

column_size

int

Bu sütundeğeri olası en büyük boyutu.

data_type_sql

smallint

Belirten sayı SQL Server sütunveri türünü.

column_precision

tinyint

' % S'sütunun sütun göre en yüksek düzeyde doğruluk bPrecision ole DBdeğer.

column_scale

tinyint

Ondalık noktanın sağındaki basamak sayısı numeric veya decimal veri türleri olarak başına bScale ole DBdeğer.

order_position

int

sütun sonuç kümesi, göreceli olarak en soldaki sütunsırası anahtar sütun konumunu sıralamada alıyorsa.

order_direction

varchar(1)(Null olabilecek)

A = sütun sipariş, anahtar , sipariş artan.

D = sütun sipariş anahtar , sıralama azalan.

null = sütun sıralamada yer almaz.

hidden_column

smallint

0 = bu sütun seçme listesinde görünür.

1 Gelecekte kullanılmak üzere ayrılmış =.

columnid

int

Sütun kimliği temel sütun.Bir ifade, result\ küme sonuç kümesisütun oluşturulmuşsa columnid -1 arasındadır.

objectid

int

Nesne veya sütunJohannes temel tablo nesne kimliği.Bir ifade, result\ küme sonuç kümesisütun oluşturulmuşsa objectid -1 arasındadır.

dbid

int

' % S'sütun sütunJohannes temel tablo içeren bir veritabanı kimliği.Bir ifade, result\ küme sonuç kümesisütun oluşturulmuşsa dbid -1 arasındadır.

dbname

sysname

(Null olabilecek)

sütunJohannes temel tablo içeren veritabanının adı.Bir ifade, result\ küme sonuç kümesisütun oluşturulmuşsa dbname ise null.

Açıklamalar

sp_describe_cursor_columnssonuç kümesi , bir sunucu imleçher imleçadı ve veri türü gibi sütun özniteliklerini açıklar.Use sp_describe_cursor Genel sunucu imleçözniteliklerini açıklaması.Use sp_describe_cursor_tables ' % s'imleç imleçtarafından başvurulan temel tablolar, rapor.Bir rapor almak için Transact-SQL server imleçler görünür bağlantı kullanmak sp_cursor_list.

İzinler

Üyelik gerektiren public rolü.

Örnekler

Aşağıdaki örnek genel imleç açar ve kullanan sp_describe_cursor_columns imleçiçinde kullanılan sütunlar raporlamak için.

USE AdventureWorks2008R2;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Person;
GO
OPEN abc;

-- Declare a cursor variable to hold the cursor output variable
-- from sp_describe_cursor_columns.
DECLARE @Report CURSOR;

-- Execute sp_describe_cursor_columns into the cursor variable.
EXEC master.dbo.sp_describe_cursor_columns
    @cursor_return = @Report OUTPUT
    ,@cursor_source = N'global' 
    ,@cursor_identity = N'abc';

-- Fetch all the rows from the sp_describe_cursor_columns output cursor.
FETCH NEXT from @Report;
WHILE (@@FETCH_STATUS <> -1)
BEGIN
   FETCH NEXT from @Report;
END

-- Close and deallocate the cursor from sp_describe_cursor_columns.
CLOSE @Report;
DEALLOCATE @Report;
GO
-- Close and deallocate the original cursor.
CLOSE abc;
DEALLOCATE abc;
GO