sp_describe_cursor_columns (Transact-SQL)
Sonuç sütun özniteliklerini raporlarını küme bir sunucu imlecin.
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