[SQL] Unique 條件約束

以往要在 Table 上建立 Unique 條件約束，都是以建立 Unqiue Index 來達成，在 Line 社群上看見討論提到，建立 Unique 條件約束，也會自動建立一個 Unique Index 出來，基本上從 Index 或是 Constraint 來建立，底層都會是 Unique Index

建立 Unique Constraint 語法

ALTER TABLE TableName   
ADD CONSTRAINT AK_TableName_ColName UNIQUE (ColName);   
GO  

建立 Unique Index 語法

CREATE UNIQUE INDEX UQ_TableName_ColName
ON dbo.TableName (ColName)
GO  

完整範例

USE AdventureWorks2025;  
GO

DROP TABLE IF EXISTS tblUniqueDemo
GO

CREATE TABLE tblUniqueDemo
 (  
    ID int NOT NULL CONSTRAINT PK_tblUniqueDemo　PRIMARY KEY,
    Email VARCHAR(100),
    Phone VARCHAR(20)
);   
GO

-- 建立 Unique Constraint 語法
ALTER TABLE tblUniqueDemo
ADD CONSTRAINT AK_tblUniqueDemo_Email UNIQUE (Email);   
GO  

-- 建立 Unique Index 語法
CREATE UNIQUE INDEX UQ_tblUniqueDemo_Phone
ON dbo.tblUniqueDemo (Phone)
GO  

-- 透過 sys.Indexes 查詢
SELECT 
    [name] ,
    [type] ,
    [type_desc] ,
    is_primary_key ,
    is_unique ,
    is_unique_constraint
FROM sys.indexes 
WHERE object_id = object_id('tblUniqueDemo')

sys.indexes 內有兩個 Unique 相關欄位資訊，分別為

• is_unique：Index is unique.
• is_unique_constraint：Index is part of a UNIQUE constraint.，白話翻譯就是是否從 Constraint 語法建立出來的

SSMS 內觀察，兩種建立方式，Unique Index 圖示也會不同

• 延伸閱讀 
• [SQL] 移除叢集索引
• 參考資料
• 建立唯一的條件約束
• 修改唯一條件約束
• 刪除唯一的條件約束

[Gemini] 連結的應用程式

在網路上看見有人提到 Gemini 沒有辦法直接讀取 Google Workspace 服務，要在 Gemini 內開啟 [連結的應用程式] 才可以讀取

以讀取 Gmail 存取為例

設定 => 個人化智慧服務 => 連結的應用程式

開啟 Google Workspace 服務

再次嘗試，Gemini 就可以存取啦

[C#] Math.DivRem

以商業邏輯出貨包裝數量為例子來記錄不同計算寫法

namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string[] args)
        {
            int 總出貨數量 = 24;
            int 預計包裝數量 = 5;

            // 傳統寫法一：/ 搭配 %
            int 實際包裝數量_1 = 總出貨數量 / 預計包裝數量;
            int 剩餘數量_1 = 總出貨數量 % 預計包裝數量;

            if (剩餘數量_1 > 0)
                實際包裝數量_1++;

            // 傳統寫法二：Math.Ceiling 無條件進位
            int 實際包裝數量2 = (int)Math.Ceiling((double)總出貨數量 / 預計包裝數量);

            // .NET Framework：透過 out 回傳剩餘數量
            int 實際包裝數量_3 = Math.DivRem(總出貨數量, 預計包裝數量, out int 剩餘數量_3);
            if (剩餘數量_3 > 0)
                實際包裝數量_3++;

            // .NET 6 新增：使用 Tuple 回傳
            var (實際包裝數量_4, 剩餘數量_4) = Math.DivRem(總出貨數量, 預計包裝數量);
            if (剩餘數量_4 > 0)
                實際包裝數量_4++;

            Console.WriteLine($"/ 搭配 %： {實際包裝數量_1}");
            Console.WriteLine($"Math.Ceiling 無條件進位： {實際包裝數量2}");
            Console.WriteLine($"透過 out 回傳剩餘數量： {實際包裝數量_3}");
            Console.WriteLine($"使用 Tuple 回傳： {實際包裝數量_4}");
        }
    }
}

• 延伸閱讀
• [C#] Deconstruct - 自訂型別
• 參考資料
• Math.DivRem

[GAS] Utilities.getUuid()

AI 產出 Code 在 js 刪除 Google Sheet 資料時，常常會看見把資料反向排序後，再依序刪除做法，避免破壞 Google Sheet RowPosition，想說要給在新增資料時給定唯一識別碼，發現 GAS 內建就有 Utilities.getUuid() 可以使用，這樣就可以明確直接刪除特定資料

[GAS] OTP 登錄

在了解 [GAS] CacheService 如何使用後，該筆記範例是 OTP 登錄範例，OTP (One Time Password) 相關操作都會在 CacheService 上進行

gs Code

/**
 * 處理 Web App 的 HTTP GET 請求，回傳使用者介面。
 * @param {Object} e - 事件物件 (GET 參數)。
 * @return {HtmlOutput} 渲染後的 HTML 畫面。
 */
function doGet(e) {
  return HtmlService.createHtmlOutputFromFile('Index')
      .setTitle('OTP 登入')
      .setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);
}

/**
 * 產生並發送 OTP 至指定 Email，同時將 OTP 寫入 CacheService。
 * @param {string} email - 使用者的電子郵件地址。
 * @return {Object} 包含執行結果的狀態物件 {success: boolean, message: string}。
 */
function generateAndSendOTP(email) {
  try {
    if (!email || !email.includes('@')) {
      return { success: false, message: '請提供有效的 Email 地址格式' };
    }

    // 產生 6 位數隨機 OTP
    const otp = Math.floor(100000 + Math.random() * 900000).toString();

    // 取得 Script 層級的 Cache，將 email 當作 Key，OTP 當作 Value
    const cache = CacheService.getScriptCache();
    // 設定快取保留時間為 300 秒 (5 分鐘)
    cache.put(email, otp, 300);

    // 寄送包含 OTP 的電子郵件
    const subject = '您的系統登入一次性密碼 (OTP)';
    const body = '您好，\n\n您的登入驗證碼為：' + otp + '\n此驗證碼將於 5 分鐘後失效。\n\n若非本人操作請忽略此信件。';
    GmailApp.sendEmail(email, subject, body);

    return { success: true, message: 'OTP 已發送至您的信箱，請於 5 分鐘內輸入。' };
  } catch (error) {
    return { success: false, message: '系統錯誤：' + error.message };
  }
}

/**
 * 驗證使用者輸入的 OTP 是否與 CacheService 中的記錄相符。
 * @param {string} email - 使用者的電子郵件地址。
 * @param {string} otp - 使用者輸入的 OTP。
 * @return {Object} 包含驗證結果的狀態物件 {success: boolean, message: string}。
 */
function verifyOTP(email, otp) {
  try {
    const cache = CacheService.getScriptCache();
    const cachedOtp = cache.get(email);

    if (!cachedOtp) {
      return { success: false, message: 'OTP 已過期或不存在，請重新獲取。' };
    }

    if (cachedOtp === otp) {
      // 驗證成功後，基於安全性應立即移除 Cache 中的 OTP
      cache.remove(email);
      return { success: true, message: '驗證成功！歡迎登入系統。' };
    } else {
      return { success: false, message: 'OTP 錯誤，請重新輸入。' };
    }
  } catch (error) {
    return { success: false, message: '驗證時發生系統錯誤：' + error.message };
  }
}

執行結果

收到 OTP email

使用 OTP 密碼登錄

Index.html 不是該筆記重點，就不放在文章上囉