Aracılığıyla paylaş

  • Makale

sp_describe_cursor_columns (Transact-SQL)

Sonuç sütun özniteliklerini raporlarını küme bir sunucu imlecin.

Topic link iconTransact-SQL sözdizimi kuralları

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_variableOUTPUT
    Is the name of a declared cursor variable to receive the cursor output.output_cursor_variable is cursor, with no default, and must not be associated with any cursors at the time sp_describe_cursor_columns is called.Döndürülen imleç kaydırılabilir, dinamik ve salt okunur bir imleç olur.

  • [ cursor_source = { N'local '| N'global ' | N'variable ' }
    Imleci, bildirilen bir yerel imleç, genel bir imleç veya imleç değişken adını kullanarak belirtilen olup olmadığını belirtir.Parametre nvarchar(30).

  • [ @cursor_identity = ] N'local_cursor_name'
    Is the name of a cursor created by a DECLARE CURSOR statement that either has the LOCAL keyword or that defaulted to LOCAL.local_cursor_name is nvarchar(128).

  • [ @cursor_identity = ] N'global_cursor_name'
    Is the name of a cursor created by a DECLARE CURSOR statement that either has the GLOBAL keyword or that defaulted to GLOBAL.global_cursor_name is nvarchar(128).

    global_cursor_name bir ODBC uygulaması tarafından açılmış ve sonra da çaðýrarak adlı bir API sunucu imleci adı olabilir. SQLSetCursorName.

  • [ @cursor_identity = ] N'input_cursor_variable'
    Is the name of a cursor variable associated with an open cursor.input_cursor_variable is nvarchar(128).

Dönüş Kodu Değerleri

None

Döndürülen imleçler

sp_describe_cursor_columns encapsulates its report as a Transact-SQLcursor output parameter.Bu olanak verir. Transact-SQL toplu işlemleri, saklı yordamları ve Tetikleyicileri çıktı bir satır ile aynı anda çalışmak için. Bu, ayrıca yordamı veritabanı API işlevleri doğrudan çağrılamaz anlamına gelir.The imleç output parameter must be bound to a program variable, but the database APIs do not support bağlama imleç parameters or variables.

Aşağıdaki tablo, imleç kullanarak döndürdü biçimini gösterir. sp_describe_cursor_columns.

Sütun adı

Veri türü

Açıklama

sütun_adı

sysname (null)

Sonuç olarak atanan ad küme sütun.Sütun NULL ise sütun ile bir yan tümce birlikte olmadan belirtildi.

ORDINAL_POSITION

int

Sonuç sütunu en soldaki sütun göreli konumunu ayarlayın.Ilk sütun konumunu 0.

column_characteristics_flags

int

DBCOLUMNFLAGS OLE DB içinde saklanan bilgileri gösteren BIR bit maskesi.Bir veya bir birleşimini aşağıdaki gibi olabilir:

1 Yer işareti =

2 = Sabit uzunluk

4 Nullable =

8 Satır sürüm =

16 (Hiçbir FOR UPDATE yan tümcesine sahip bir imleç için öngörülen sütunları küme ve bir sütunu varsa, yalnızca bir imleç başına olabilir) güncelleştirilebilir sütun =.

Bit değerlerini birleştirildiğinde, Birleşik bit değerlerin uygulanır.Bit değeri 6, sütunun bir sabit uzunluklu (2) ise, null (4) sütun.

column_size

int

Bu değer en büyük olası boyutunu sütun.

data_type_sql

smallint

Belirten sayı SQL Server sütunun veri türü.

column_precision

tinyint

Sütun olarak başına en fazla duyarlık bPrecision OLE DB değeri.

column_scale

tinyint

Için ondalık virgülün sağındaki basamak sayısı numeric veya decimal olarak, veri türleri bScale OLE DB değeri.

order_position

int

Sütun sonucunu sıralamada alıyorsa küme, sütunun konumunu sırada anahtar en soldaki sütunu bağlantılıdır.

order_direction

varchar(1)(null)

A = sütun sıradır anahtar ve sıralama artan.

D = sütun sırası anahtardır ve sıralama azalan.

NULL = sıralamada sütuna katılmayan.

hidden_column

smallint

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

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

ColumnID

int

Temel sütununun sütun KIMLIĞI.Sonuç küme sütun, bir ifadeden oluşturuldu ColumnID is -1.

ObjectId

int

Nesne KIMLIĞI sütun sağlayan nesne veya temel tablo.Sonuç küme sütun, bir ifadeden oluşturuldu ObjectId is -1.

DBID

int

TEŞHIS kodu içeren bir veritabanı temel tablo, sütun sağlama.Sonuç küme sütun, bir ifadeden oluşturuldu DBID is -1.

dbname

sysname

(null)

Sütun sağlayan temel tabloyu içeren veritabanının adı.Sonuç küme sütun, bir ifadeden oluşturuldu dbname NULL olur.

Remarks

sp_describe_cursor_columns her imleç adı ve veri türü gibi bir sunucu imleci sonuç kümesindeki sütunların özniteliklerini açıklar.Kullanımı sp_describe_cursor genel sunucu imleç özniteliklerinin bir açıklaması.Kullanımı sp_describe_cursor_tables imleç tarafından başvurulan temel tablolar hakkında bir rapor için.Bir rapor elde etmek için Transact-SQL Sunucu imleçleri bağlantıda görünen kullanın. sp_cursor_list.

İzinler

Üyelik gerektirir Ortak roldür.

Örnekler

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

USE AdventureWorks;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Contact;
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