مقدمه و مسیر یادگیری

دستور DECLARE یکی از موضوع‌های مهم مجموعه دستورات کاربردی Microsoft SQL Server است. متغیر محلی، Cursor یا Table Variable را در محدوده Batch تعریف می‌کند و پایه نگهداری حالت موقت در T-SQL است. شناخت این دستور زمانی ارزشمند می‌شود که علاوه بر شکل نوشتن، محدوده اثر، نیازمندی مجوز، رفتار در تراکنش و پیامد عملیاتی آن نیز روشن باشد.

این مقاله از تعریف و Syntax آغاز می‌کند، سپس پارامترها، خروجی، مثال‌های مستقل، خطاهای رایج، ملاحظات کارایی و بهترین روش‌های استفاده را توضیح می‌دهد. نمونه‌ها از ساده به حرفه‌ای چیده شده‌اند و بخش پرسش‌های متداول و مصاحبه نیز برای مرور سریع در نظر گرفته شده است.

پیش از اجرای نمونه‌های مدیریتی روی سرور واقعی، نام Database، مسیر فایل، شناسه Session و سطح دسترسی را با محیط خود تطبیق دهید. نمونه‌ای که شامل Backup، Restore، DBCC یا KILL باشد باید ابتدا در آزمایشگاه و با برنامه بازگشت بررسی شود.

برای دیدن جایگاه این موضوع در کنار سایر فرمان‌ها، راهنمای جامع دستورات کاربردی SQL Server را مطالعه کنید. مقاله مادر مسیر انتخاب میان فرمان‌های پیام، خطا، Session، نگهداری و بازیابی را یکجا نشان می‌دهد.

تعریف دستور DECLARE

متغیر محلی، Cursor یا Table Variable را در محدوده Batch تعریف می‌کند و پایه نگهداری حالت موقت در T-SQL است.

در SQL Server هر فرمان در یک Scope مشخص اجرا می‌شود. هنگام استفاده از DECLARE باید مشخص باشد اثر آن فقط روی عبارت فعلی، Batch، Session، Database یا کل Instance است. همین تشخیص، پایه جلوگیری از اجرای ناخواسته و طراحی درست آزمون است.

از دید مهندسی، Syntax صحیح شرط لازم است اما کافی نیست. داده ورودی، Collation، نوع داده، تنظیمات SET، سطح جداسازی، مجوز و وضعیت Connection می‌توانند نتیجه را تغییر دهند. بنابراین مثال حرفه‌ای باید پیش‌شرط و خروجی کنترلی داشته باشد.

Syntax استاندارد

DECLARE { @local_variable data_type [ = value ] } [ ,...n ] | @table_variable TABLE ( column_definition ) | cursor_name CURSOR;

پارامترها و اجزای مهم

• نام متغیر با پیشوند @
• نوع داده دقیق و طول/دقت مناسب
• مقدار اولیه اختیاری
• تعریف ستون‌ها و محدودیت‌های Table Variable
• تعریف Cursor در سناریوهای ضروری

خروجی و اثر اجرایی

DECLARE خروجی مستقیمی ندارد؛ متغیر ایجادشده تا پایان Batch یا Scope معتبر است.

اگر این دستور در Procedure، Job یا ابزار استقرار استفاده شود، Caller باید بداند موفقیت چگونه اعلام می‌شود و خطا از چه مسیری برمی‌گردد. استفاده از Result Set کنترلی، پیام کوتاه، Error Number مشخص یا رکورد لاگ باید بر اساس قرارداد پروژه انتخاب شود.

کاربردهای واقعی در پروژه

سه کاربرد پرتکرار این موضوع عبارت‌اند از ذخیره پارامترهای محاسباتی، ساخت داده موقت کوچک، کنترل حلقه و Dynamic SQL پارامتری. در هر سه حالت، مالک عملیات و معیار پذیرش باید قبل از اجرا تعیین شود و تغییر مهم بدون نسخه پشتیبان یا مسیر Rollback انجام نشود.

در پروژه سازمانی بهتر است فرمان داخل یک Runbook یا اسکریپت نسخه‌بندی‌شده قرار گیرد. نام سرور و Database از محیط دریافت شود، ولی Identifier پویا فقط پس از اعتبارسنجی و QUOTENAME ساخته شود. مقادیر داده نیز در Dynamic SQL به‌صورت پارامتر ارسال شوند.

قاعده عملی: DECLARE را فقط زمانی اجرا کنید که بتوانید در یک جمله بگویید چه چیزی تغییر می‌کند، موفقیت چگونه سنجیده می‌شود و در صورت شکست چه اقدامی انجام خواهد شد.

مثال‌های عملی مستقل

ده مثال زیر جنبه‌های متفاوت DECLARE را پوشش می‌دهند. هر نمونه هدف، Query، خروجی مورد انتظار و نکته عملیاتی دارد. فرمان‌های دارای اثر مدیریتی با نام‌ها و مسیرهای نمونه نوشته شده‌اند و باید پیش از اجرا شخصی‌سازی و تأیید شوند.

مثال شماره 1: تعریف متغیر عددی

در این سناریو هدف آن است که «تعریف متغیر عددی» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @Count int = 10;
SELECT @Count AS ItemCount;

نوع int برای شمارنده‌های معمول مناسب است. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 2: تعریف رشته یونیکد

در این سناریو هدف آن است که «تعریف رشته یونیکد» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @Title nvarchar(100) = N'آموزش SQL Server';
SELECT @Title AS Title;

طول متغیر را متناسب با قرارداد داده تعیین کنید. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 3: تعریف چند متغیر

در این سناریو هدف آن است که «تعریف چند متغیر» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @Price decimal(12,2) = 125.50, @Quantity int = 4;
SELECT @Price * @Quantity AS TotalAmount;

decimal برای مبلغ از خطای تقریب float جلوگیری می‌کند. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 4: مقدار پیش‌فرض NULL

در این سناریو هدف آن است که «مقدار پیش‌فرض NULL» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @OptionalValue nvarchar(20);
SELECT COALESCE(@OptionalValue, N'تعیین نشده') AS DisplayValue;

متغیر بدون مقدار اولیه NULL است و باید آگاهانه مدیریت شود. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 5: متغیر تاریخ و زمان

در این سناریو هدف آن است که «متغیر تاریخ و زمان» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @CreatedAt datetime2(3) = SYSUTCDATETIME();
SELECT @CreatedAt AS CreatedAtUtc;

datetime2 برای توسعه جدید نسبت به datetime دامنه و دقت بهتری دارد. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 6: Table Variable ساده

در این سناریو هدف آن است که «Table Variable ساده» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @Items TABLE(Id int PRIMARY KEY, Title nvarchar(50));
INSERT @Items VALUES (1, N'اول'), (2, N'دوم');
SELECT * FROM @Items ORDER BY Id;

برای مجموعه کوچک و Scope محدود، Table Variable خوانا است. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 7: تجمع روی Table Variable

در این سناریو هدف آن است که «تجمع روی Table Variable» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @Sales TABLE(Amount decimal(10,2));
INSERT @Sales VALUES (10.00), (25.50), (NULL);
SELECT SUM(Amount) AS Total FROM @Sales;

تابع SUM مقدار NULL را نادیده می‌گیرد. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 8: متغیر کنترل حلقه

در این سناریو هدف آن است که «متغیر کنترل حلقه» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @i tinyint = 1;
WHILE @i <= 3
BEGIN
    SELECT @i AS SequenceNumber;
    SET @i += 1;
END;

حلقه باید شرط خاتمه روشن داشته باشد. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 9: Dynamic SQL پارامتری

در این سناریو هدف آن است که «Dynamic SQL پارامتری» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @Sql nvarchar(max) = N'SELECT @Input * 2 AS Result;';
DECLARE @Value int = 7;
EXEC sys.sp_executesql @Sql, N'@Input int', @Input = @Value;

پارامتر از تزریق SQL و تبدیل‌های ناخواسته جلوگیری می‌کند. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

مثال شماره 10: بررسی Scope متغیر

در این سناریو هدف آن است که «بررسی Scope متغیر» به شکلی روشن و قابل بازتولید بررسی شود. Query زیر یک Batch کامل ارائه می‌دهد و می‌توان آن را پس از کنترل Context و مجوزها در محیط آزمایش اجرا کرد.

DECLARE @OuterValue int = 9;
EXEC sys.sp_executesql N'SELECT @P AS InsideValue;', N'@P int', @P = @OuterValue;
SELECT @OuterValue AS OutsideValue;

متغیر بیرونی باید صریح به Batch پویا پاس داده شود. در محیط عملیاتی بهتر است ورودی، زمان اجرا، نام پایگاه داده و نتیجه نهایی نیز در یک لاگ ساختاریافته ثبت شود تا عیب‌یابی و ممیزی بعدی قابل اتکا باشد.

خطاهای رایج و روش پیشگیری

انتخاب طول کوتاه باعث بریدن داده می‌شود. این خطا معمولاً زمانی رخ می‌دهد که نمونه آموزشی بدون بررسی Context یا Scope به Production منتقل می‌شود. افزودن Guard، نمایش مقصد و توقف سریع با THROW راه پیشگیری قابل اتکایی است.

متغیر مقداردهی‌نشده NULL است. برای کنترل این وضعیت، ورودی‌ها را پیش از اجرا اعتبارسنجی کنید و نتیجه مرحله حساس را با Query مستقل بسنجید. اگر عملیات قابل Rollback نیست، تأیید دوم و Backup معتبر ضروری است.

متغیر خارج از Batch یا Dynamic SQL قابل مشاهده نیست. مستندسازی رفتار مورد انتظار و ثبت Error Number، Message، State و زمان اجرا باعث می‌شود تیم به جای آزمون و خطای تکراری، علت را بر اساس شواهد پیدا کند.

• نام Database و Instance پیش از اجرا کنترل شود.
• مجوز حساب اجرا با اصل کمترین دسترسی تعیین شود.
• در مسیر CATCH وضعیت تراکنش و تنظیمات Session تعیین تکلیف شود.
• Query کنترلی پس از عملیات، نتیجه واقعی را ثابت کند.

ملاحظات Performance و هم‌زمانی

نوع داده متغیر را با ستون مقایسه‌شونده یکسان کنید. ارزیابی کارایی باید بر اساس Baseline و در بازه زمانی مشخص باشد؛ یک Execution Plan یا عدد تجمعی بدون مقایسه، برای تصمیم Production کافی نیست.

برای داده حجیم Table Variable را با Temp Table مقایسه کنید. اگر فرمان روی IO، Transaction Log، Worker Thread یا قفل اثر دارد، Wait Type و Blocking هم‌زمان بررسی شود. افزایش سرعت یک Batch نباید با طولانی‌شدن توقف کاربران جبران شود.

Cursor را تنها وقتی راه‌حل مجموعه‌محور مناسب نیست به کار ببرید. برای اجرای دوره‌ای، Duration، نتیجه، تعداد ردیف، حجم داده و خطاها در جدول تاریخچه ثبت شود. این تاریخچه ظرفیت‌سنجی و تشخیص تغییر رفتار پس از ارتقای نسخه را ممکن می‌کند.

بهترین روش‌ها

1. هدف و Scope دستور DECLARE را در ابتدای اسکریپت توضیح دهید.
2. از نام Schema، نوع داده و تبدیل صریح استفاده کنید.
3. مقادیر فارسی را با N و نوع nvarchar نگه دارید.
4. برای خطای واقعی از TRY/CATCH و THROW استفاده کنید.
5. تراکنش را کوتاه نگه دارید و XACT_STATE را در CATCH کنترل کنید.
6. اسکریپت را تا حد ممکن قابل اجرای مجدد طراحی کنید.
7. خروجی کنترلی و معیار پذیرش را در همان فایل قرار دهید.
8. نسخه SQL Server و تفاوت محیط Cloud را پیش از استقرار بررسی کنید.

مقایسه DECLARE با جدول موقت برای حجم بیشتر و آمار بهینه‌ساز باید بر اساس نیاز واقعی انجام شود. انتخاب فناوری یا فرمان صرفاً به دلیل آشنایی قبلی، ممکن است خوانایی، سازگاری یا قابلیت پشتیبانی آینده را کاهش دهد.

سؤالات متداول

سؤال 1: دستور DECLARE در SQL Server دقیقاً چه کاری انجام می‌دهد؟

دستور DECLARE متغیر محلی، Cursor یا Table Variable را در محدوده Batch تعریف می‌کند و پایه نگهداری حالت موقت در T-SQL است. دامنه اثر آن باید پیش از اجرا شناخته شود و نمونه نخست در محیط آزمایش بررسی شود تا انتظار تیم از پیام، Result Set یا تغییر وضعیت Session دقیق باشد.

سؤال 2: برای شروع یادگیری DECLARE چه پیش‌نیازی لازم است؟

آشنایی با Batch، Session، نوع داده، مجوز و تفاوت محیط توسعه و تولید کافی است. ابتدا Syntax و مثال‌های پایه را اجرا کنید، سپس رفتار خطا و تراکنش را با داده کوچک بسنجید و در پایان سراغ سناریوی سازمانی بروید.

سؤال 3: DECLARE چه ارزش تجاری برای یک سامانه داده دارد؟

کاربرد درست آن می‌تواند زمان توقف، خطای انسانی و هزینه عیب‌یابی را کاهش دهد. ارزش واقعی زمانی ایجاد می‌شود که فرمان در Runbook، کنترل دسترسی، مانیتورینگ و آزمون بازیابی یا استقرار قرار گیرد، نه اینکه فقط یک دستور منفرد باشد.

سؤال 4: آیا استفاده حرفه‌ای از DECLARE هزینه پروژه SQL Server را کم می‌کند؟

بله، اگر همراه استاندارد کدنویسی، بازبینی و پایش باشد. کاهش اجرای اشتباه، کوتاه‌شدن زمان تشخیص رخداد و قابل تکرار شدن عملیات، هزینه پشتیبانی را پایین می‌آورد؛ اما خودکارسازی بدون Guard می‌تواند ریسک را بیشتر کند.

سؤال 5: تفاوت DECLARE با جدول موقت برای حجم بیشتر و آمار بهینه‌ساز چیست؟

DECLARE برای متغیر محلی، Cursor یا Table Variable را در محدوده Batch تعریف می‌کند و پایه نگهداری حالت موقت در T-SQL است. گزینه تخصصی‌تری است، درحالی‌که جدول موقت برای حجم بیشتر و آمار بهینه‌ساز دامنه یا هدف متفاوتی دارد. انتخاب باید بر اساس نیاز به سازگاری نسخه، اثر روی Session، مدیریت خطا، امکان Rollback و نتیجه قابل مشاهده انجام شود.

سؤال 6: چه زمانی برای پیاده‌سازی DECLARE از خدمات مشاوره SQL Server استفاده کنیم؟

اگر فرمان بخشی از مهاجرت، بازیابی، نگهداری Production، تغییر امنیتی یا عملیات دارای SLA است، بازبینی متخصص ارزشمند است. مشاور می‌تواند پیش‌نیاز، اسکریپت برگشت، مانیتورینگ، تست بار و معیار پذیرش را قبل از اجرا مشخص کند.

سؤال 7: رایج‌ترین خطا هنگام کار با DECLARE چیست؟

انتخاب طول کوتاه باعث بریدن داده می‌شود. همچنین بی‌توجهی به Context، مجوز و Scope باعث می‌شود نمونه‌ای که در آزمایش موفق بوده در Production رفتار دیگری نشان دهد. راه‌حل، Guard صریح، TRY/CATCH و ثبت ورودی‌های واقعی است.

سؤال 8: اثر DECLARE بر Performance چگونه ارزیابی می‌شود؟

نوع داده متغیر را با ستون مقایسه‌شونده یکسان کنید. پیش و پس از اجرا باید Duration، CPU، IO، Waitها، Blocking و حجم Log متناسب با موضوع اندازه‌گیری شود. یک Snapshot منفرد کافی نیست و مقایسه با Baseline دوره مشابه نتیجه معتبرتری می‌دهد.

سؤال 9: بهترین روش استفاده از DECLARE چیست؟

بهترین روش این است که هدف، Context، مجوز، اثر تراکنشی، Timeout و مسیر بازگشت مستند شوند. اسکریپت باید قابل اجرای مجدد یا دست‌کم دارای کنترل جلوگیری از اجرای دوباره باشد و نتیجه نهایی را به‌صورت قابل ممیزی گزارش کند.

سؤال 10: DECLARE با کدام نسخه‌های SQL Server سازگار است؟

انتساب مقدار در DECLARE در نسخه‌های مدرن پشتیبانی می‌شود؛ قابلیت‌های Table Variable با نسخه و Compatibility Level تفاوت دارند. علاوه بر شماره نسخه، Compatibility Level، Edition، سیستم‌عامل، سرویس ابری و مجوز حساب اجرا نیز باید در محیط مقصد آزموده شود؛ مستندات همان نسخه مرجع نهایی تصمیم است.

سؤالات مصاحبه SQL Server

پرسش مصاحبه 1: در مصاحبه چگونه کاربرد DECLARE را توضیح دهیم؟

ابتدا هدف را در یک جمله بگویید، سپس Scope اثر، یک مثال واقعی، خطر اصلی و روش کنترل آن را شرح دهید. پاسخ حرفه‌ای فقط Syntax نیست و باید نشان دهد اثر دستور روی Session، Transaction، IO یا بازیابی را می‌فهمید.

پرسش مصاحبه 2: چه نکته‌ای پاسخ مبتدی و حرفه‌ای درباره DECLARE را جدا می‌کند؟

پاسخ حرفه‌ای درباره خطا، مجوز، قابلیت اجرای مجدد، مشاهده‌پذیری و تفاوت محیط آزمایش و Production صحبت می‌کند. همچنین جایگزین مناسب و دلیل انتخاب را بیان می‌کند.

پرسش مصاحبه 3: اگر اجرای DECLARE شکست بخورد چه می‌کنید؟

ابتدا Error Number، Message، State، Context، ورودی و وضعیت تراکنش ثبت می‌شود. سپس بدون تکرار کورکورانه، علت بررسی و بر اساس Runbook مسیر Rollback یا Retry کنترل‌شده اجرا می‌شود.

پرسش مصاحبه 4: چگونه DECLARE را برای Production آماده می‌کنید؟

حداقل مجوز، Guard مقصد، ورودی پارامتری، Timeout، TRY/CATCH، ثبت نتیجه، آزمون روی داده نماینده و تأیید مالک سرویس لازم است. برای عملیات مدیریتی، پنجره اجرا و برنامه بازگشت نیز تعیین می‌شود.

پرسش مصاحبه 5: چه معیارهایی موفقیت DECLARE را ثابت می‌کنند؟

معیار باید قابل اندازه‌گیری باشد: نتیجه داده، وضعیت Session یا Database، زمان اجرا، نبود خطای جدید، اثر قابل قبول بر IO و Blocking و ثبت خروجی کنترلی. معیار پذیرش پیش از اجرا نوشته می‌شود.

چک‌لیست نهایی

• Context پایگاه داده و نام Instance تأیید شد.
• Syntax و ورودی‌ها در محیط آزمایش اجرا شدند.
• مجوزها و اثر روی Session یا Database مشخص است.
• مسیر خطا، Rollback و Timeout بررسی شده است.
• اثر کارایی با Baseline مقایسه می‌شود.
• خروجی کنترلی و لاگ نهایی تعریف شده است.
• برای عملیات حساس، Backup و تأیید مالک سرویس وجود دارد.
• اسکریپت و نتیجه اجرا نسخه‌بندی و مستند می‌شوند.

جمع‌بندی

دستور DECLARE زمانی به‌درستی استفاده شده است که علاوه بر نتیجه فنی، ریسک عملیاتی آن هم مدیریت شود. در این مقاله Syntax، پارامترها، ده سناریوی مستقل، خروجی نمونه، خطاها، Performance، Best Practice و پرسش‌های مصاحبه بررسی شد تا بتوانید فرمان را آگاهانه در Query، Procedure، Job یا Runbook به کار ببرید.

برای مرور ارتباط DECLARE با دیگر موضوع‌های این مجموعه، به مقاله مادر دستورات کاربردی SQL Server بازگردید. پیش از استفاده در Production، نمونه مرتبط را با نام‌ها، مسیرها، مجوزها و SLA واقعی سازمان خود تطبیق دهید.