沒墨的筆記本

關閉快速啟動與 PCIe 省電，解決筆電黑屏喚醒失敗

Tue, 28 Jul 2026 00:00:00 GMT

結論

Windows 筆電鎖定後若黑屏無法喚醒，可先關閉「快速啟動」與「PCIe 連結狀態電源管理」，目前實測可恢復正常。

適合用在哪裡

鎖定螢幕或待機後，畫面無法再次亮起。
鍵盤、滑鼠仍可能有反應，但只能強制重新開機。
Windows 筆電出現不固定的休眠或喚醒異常。
想先從系統電源設定排除問題，不立即重灌或送修。

流程步驟

1. 關閉 Windows 快速啟動

快速啟動會保留部分系統狀態，加快下次開機速度，但有時可能干擾休眠、關機與硬體重新初始化。

按下 Win + R，輸入 control 開啟控制台。
將「檢視方式」切換為「大圖示」。
進入「電源選項」。
點擊「選擇按下電源按鈕時的行為」。
點擊「變更目前無法使用的設定」。
取消勾選「開啟快速啟動（建議選項）」。
儲存變更後重新開機。這個設定通常是優先排查項目。若問題來自關機狀態或驅動程式沒有完整重新載入，關閉後可能改善喚醒失敗。

2. 關閉 PCIe 連結狀態電源管理

PCIe 連結狀態電源管理會降低顯示卡或其他 PCIe 裝置的耗電，但部分硬體可能無法從深度省電狀態正常恢復。

進入控制台的「電源選項」。
在目前使用的電源計畫旁，點擊「變更計畫設定」。
點擊「變更進階電源設定」。
展開「PCI Express」。
展開「連結狀態電源管理」。
將設定調整為「關閉」。
點擊「套用」並確認。若筆電分成「使用電池」與「一般電源」兩個選項，建議先全部設為關閉，再觀察黑屏問題是否仍會發生。

補充

關閉 PCIe 省電可能稍微增加耗電量，確認問題解決後，可再測試只關閉插電模式。
修改設定後務必重新開機，避免舊的電源狀態仍被保留。
若問題持續，下一步應檢查顯示卡驅動程式、BIOS 與 Windows 更新，不要一直靠強制關機硬扛。

指令 / 範例整理

<details> <summary>Click to expand</summary>

開啟控制台：
Win + R
輸入：control

快速啟動：
控制台
→ 電源選項
→ 選擇按下電源按鈕時的行為
→ 變更目前無法使用的設定
→ 取消「開啟快速啟動」

PCIe 電源管理：
控制台
→ 電源選項
→ 變更計畫設定
→ 變更進階電源設定
→ PCI Express
→ 連結狀態電源管理
→ 關閉

</details>

收尾

先關閉快速啟動，再停用 PCIe 連結狀態電源管理，是排查 Windows 鎖定黑屏問題成本最低的做法；若仍無效，再往驅動程式與 BIOS 查，莫與黑屏鬥法到天明。

SQL 即時監看筆記：Profiler 與 Azure SQL XEvent

Fri, 24 Apr 2026 00:00:00 GMT

結論

SQL Server 可直接用 SQL Server Profiler 即時監看 SQL，但 Azure SQL Database 不支援 Profiler，需要改用 Extended Events（XEvent）搭配 TSQL 查詢事件資料。

適合用在哪裡

查詢「誰正在打 SQL」
分析 API / 系統即時 SQL
排查慢查詢與高 CPU SQL
Azure SQL 無法使用 Profiler 時
DBA / 後端工程師效能分析

流程步驟

1. 一般 SQL Server：直接使用 SQL Server Profiler

SQL Server 傳統最常見做法
可即時看到：
- 執行中的 SQL
- Duration
- CPU
- Login User
- Application Name
適合：
- On-Prem SQL Server
- VM SQL Server
- 短時間即時除錯操作位置：
SSMS → Tools → SQL Server Profiler

常用事件：

RPC:Completed
SQL:BatchCompleted
SP:StmtCompleted 常用 Filter：

ApplicationName
LoginName
DatabaseName
Duration
TextData

實務上通常一定要加 Filter，不然大型系統會像瀑布一樣噴 SQL，眼睛直接工傷 (´-ω-`)

2. Azure SQL Database：改用 Extended Events（XEvent）

Azure SQL Database 不支援 SQL Server Profiler
官方也逐漸建議改用 XEvent
效能比 Profiler 更好
可自訂追蹤條件建立 XEvent Session：

CREATE EVENTSESSION MonitorSQL
ON DATABASE
ADD EVENT sqlserver.sql_batch_completed(
ACTION (
        sqlserver.client_app_name,
        sqlserver.client_hostname,
        sqlserver.username
    )
)
ADD TARGET package0.ring_buffer;
GO

啟動 Session：

ALTER EVENTSESSION MonitorSQL
ON DATABASE
STATE=START;
GO

操作位置：

SSMS → XEvent 分析工具 → TSQL

這邊使用：

sql_batch_completed
- 監看 SQL 執行完成
ring_buffer
- 暫存記憶體事件
- 不需額外檔案權限 Azure SQL 很多環境沒有檔案系統權限，因此通常會優先用 ring_buffer。

3. 使用 TSQL 查詢即時 SQL 內容

建立完成後，可直接查詢 XEvent 內容：

SELECT
    event_data.value('(event/@name)[1]','varchar(50)')AS EventName,
    event_data.value('(event/data[@name="duration"]/value)[1]','bigint')/1000AS DurationMs,
    event_data.value('(event/action[@name="client_app_name"]/value)[1]','nvarchar(256)')AS AppName,
    event_data.value('(event/action[@name="username"]/value)[1]','nvarchar(256)')AS UserName,
    event_data.value('(event/data[@name="batch_text"]/value)[1]','nvarchar(max)')AS SQLText
FROM (
SELECTCAST(xet.target_dataAS XML)AS target_data
FROM sys.dm_xe_database_sessions s
JOIN sys.dm_xe_database_session_targets xet
ON s.address= xet.event_session_address
WHERE s.name='MonitorSQL'
) t
CROSS APPLY target_data.nodes('//RingBufferTarget/event')AS x(event_data);

可看到：

SQL 內容
執行時間
使用者
呼叫 App
Host Name 對 API 系統非常好用，尤其查：
哪支 API 打爆 DB
EF Core 產生什麼 SQL
哪個排程在狂跑

補充

Profiler 長時間開啟效能較差，不建議正式機長期使用
Azure SQL 建議搭配 Query Store 一起分析慢 SQL
XEvent 若沒停止，事件資料會持續累積

指令 / 範例整理

<details> <summary>Click to expand</summary>

-- 建立 XEvent
CREATE EVENTSESSION MonitorSQL
ON DATABASE
ADD EVENT sqlserver.sql_batch_completed(
ACTION (
        sqlserver.client_app_name,
        sqlserver.client_hostname,
        sqlserver.username
    )
)
ADD TARGET package0.ring_buffer;
GO

-- 啟動 XEvent
ALTER EVENTSESSION MonitorSQL
ON DATABASE
STATE=START;
GO

-- 查詢 XEvent
SELECT
    event_data.value('(event/@name)[1]','varchar(50)')AS EventName,
    event_data.value('(event/data[@name="duration"]/value)[1]','bigint')/1000AS DurationMs,
    event_data.value('(event/action[@name="client_app_name"]/value)[1]','nvarchar(256)')AS AppName,
    event_data.value('(event/action[@name="username"]/value)[1]','nvarchar(256)')AS UserName,
    event_data.value('(event/data[@name="batch_text"]/value)[1]','nvarchar(max)')AS SQLText
FROM (
SELECTCAST(xet.target_dataAS XML)AS target_data
FROM sys.dm_xe_database_sessions s
JOIN sys.dm_xe_database_session_targets xet
ON s.address= xet.event_session_address
WHERE s.name='MonitorSQL'
) t
CROSS APPLY target_data.nodes('//RingBufferTarget/event')AS x(event_data);

-- 停止 XEvent
ALTER EVENTSESSION MonitorSQL
ON DATABASE
STATE= STOP;
GO

-- 刪除 XEvent
DROP EVENTSESSION MonitorSQLON DATABASE;
GO

</details>

收尾

以前抓 SQL 靠 Profiler，現在 Azure SQL 時代，XEvent 幾乎已經是標配了。

會寫一份 XEvent TSQL，很多效能問題就不用靠運氣通靈。

MSSQL RESTORE DATABASE 實戰：用 FILE + MOVE 還原成新 DB

Fri, 17 Apr 2026 00:00:00 GMT

結論

使用 RESTORE FILELISTONLY + MOVE 可把備份檔還原成另一個新資料庫名稱，避免覆蓋原 DB，也能順便重新指定 MDF / LDF 路徑。

適合用在哪裡

還原正式環境備份到測試環境
複製一份資料庫做查詢分析
上版前先建立測試副本
原 DB 不能動，但需要資料驗證

流程步驟

1. 先確認備份檔內容與版本

先查看 .bak 是否可用、備份類型是否正確。若是多組備份，也能確認要還原哪一份。

RESTORE HEADERONLY
FROM DISK = N'C:\\SampleBackup\\DemoDb_backup_2026_04_17_163005.bak';

若看到 BackupType = 1 通常代表完整備份，可直接還原。

2. 查詢資料檔邏輯名稱

還原時 MOVE 用的不是實體檔名，而是備份內的邏輯名稱，這一步必查，不然常報錯。

RESTORE FILELISTONLY
FROM DISK = N'C:\\SampleBackup\\DemoDb_backup_2026_04_17_163005.bak';
GO

你會看到類似：

LogicalName	Type
DemoDb	D
DemoDb_log	L

之後 MOVE 就使用這兩個名稱。

3. 還原成新的資料庫名稱

建立新資料庫 DemoDb_Copy260417，並把資料檔放到新路徑，避免與原本 DB 衝突。

RESTORE DATABASE [DemoDb_Copy260417]
FROM DISK = N'C:\\SampleBackup\\DemoDb_backup_2026_04_17_163005.bak'
WITH
    FILE = 1,
    MOVE N'DemoDb' TO N'D:\\MSSQL\\Data\\DemoDb_Copy260417.mdf',
    MOVE N'DemoDb_log' TO N'D:\\MSSQL\\Log\\DemoDb_Copy260417.ldf',
    RECOVERY,
    STATS = 10;
GO

STATS = 10 代表每 10% 顯示一次進度，做人要有回報，SQL 也是。

補充

FILE = 1 通常是第一組備份；若同一 bak 含多份備份，需先用 HEADERONLY 確認 Position。
若 MDF / LDF 路徑不存在，還原會失敗，先建資料夾。
若目標 DB 已存在，可先刪除或加 REPLACE（正式環境慎用）。

指令 / 範例整理

<details> <summary>Click to expand</summary>

RESTORE HEADERONLY
FROM DISK = N'C:\\SampleBackup\\DemoDb_backup_2026_04_17_163005.bak';

RESTORE FILELISTONLY
FROM DISK = N'C:\\SampleBackup\\DemoDb_backup_2026_04_17_163005.bak';
GO

RESTORE DATABASE [DemoDb_Copy260417]
FROM DISK = N'C:\\SampleBackup\\DemoDb_backup_2026_04_17_163005.bak'
WITH
    FILE = 1,
    MOVE N'DemoDb' TO N'D:\\MSSQL\\Data\\DemoDb_Copy260417.mdf',
    MOVE N'DemoDb_log' TO N'D:\\MSSQL\\Log\\DemoDb_Copy260417.ldf',
    RECOVERY,
    STATS = 10;
GO

</details>

收尾

還原資料庫不難，難的是搞錯邏輯檔名與路徑。先查清楚再下手，能少踩很多雷。

SQL Server OLE DB Driver 19 Token 登入錯誤解法（降版 18.7.5）

Wed, 15 Apr 2026 00:00:00 GMT

結論

OLE DB Driver 19 可能導致 Token 登入失敗，直接降版到 18.7.5 可解

適合用在哪裡

使用 OLE DB 連線 SQL Server（含 Azure SQL）
使用 Token / AAD 驗證
發生 <token-identified principal> 登入錯誤
SSIS / Linked Server / 外部系統整合

流程步驟

1. 確認錯誤訊息

出現以下錯誤：
- Login failed for user '<token-identified principal>'
- The server is not currently configured to accept this token
通常發生在：
- 使用 OLE DB Driver 19
- 搭配 Azure AD / Token 驗證
這不是 SQL 權限問題，而是 Driver 相容性問題

2. 移除 OLE DB Driver 19 (選擇性)

到「控制台 → 程式與功能」
找到：
- Microsoft OLE DB Driver 19 for SQL Server
進行解除安裝
避免多版本混用（可能導致連線仍抓到 19）

3. 安裝指定版本 18.7.5

下載舊版 Driver（官方）：
- https://learn.microsoft.com/en-us/sql/connect/oledb/release-notes-for-oledb-driver-for-sql-server?view=sql-server-ver17#1875
安裝：
- Microsoft OLE DB Driver 18.7.5
安裝完成後重新啟動服務（如 IIS / SSIS / App）

補充

Driver 19 在某些 Token 驗證場景有相容性問題（特別是舊系統）
若使用 Linked Server，也會影響連線測試
不建議混裝 18 / 19，避免 DLL 載入混亂

收尾

有些錯不是你權限問題，是版本在搞你，降版反而最快解

Web App DNS 解析異常紀錄（Public / Private 切換）

Wed, 15 Apr 2026 00:00:00 GMT

結論

同一個 Azure Web App 會解析到不同 IP，是因為「是否走 Private Link DNS」決定的。

適合用在哪裡

Azure Web App 無法連線時排查
Private Endpoint / Private Link 設定驗證
判斷流量是走內網還是外網
DevOps / Infra troubleshooting

流程步驟

1. 使用 nameresolver 驗證 DNS 解析結果

在 Kudu 或 Web App console 執行 nameresolver.exe 查詢 domain
觀察是否解析到 public IP（13.x.x.x）或 private IP（10.x.x.x）
這一步是最快確認「流量路徑」的方式

nameresolver.exe website.azurewebsites.net

2. 判斷 Public vs Private DNS 行為

解析到 public：
- domain → *.azurewebsites.net
- IP 為 13.x.x.x
- 表示走 Azure 公網
解析到 private：
- domain → *.privatelink.azurewebsites.net
- IP 為 10.x.x.x
- 表示走 Private Endpoint 關鍵差異在於 DNS 是否被「Private DNS Zone 覆蓋」

3. 確認 Private Link / DNS Zone 設定

若有建立 Private Endpoint：
- Azure 會建立 privatelink DNS 記錄
若 VNet 有綁 Private DNS Zone：
- 會強制解析到內網 IP
若沒有綁定：
- 仍會走 public IP 簡單判斷：
同一台機器解析結果不同 → DNS 路徑不同
同一 domain 出現兩種結果 → DNS override 發生

補充

Private DNS Zone 綁在 VNet 上才會生效（常見漏設定）
Azure Web App 沒有 VNet Integration 也可能被 DNS 影響
同一 domain 在不同環境解析不同是正常現象，不是 bug

收尾

看 IP 就知道你走哪條路，別再猜網路了，DNS 才是關鍵。

如何禁止特定帳號使用 LinkServer？用假帳號直接封鎖

Wed, 08 Apr 2026 00:00:00 GMT

結論

用「假帳號 mapping」覆蓋 LinkServer 登入，讓指定使用者永遠連線失敗，是最簡單可控的封鎖方式。

適合用在哪裡

想限制「特定帳號」不能用 LinkServer
不想影響其他使用者（維持 public 可用）
無法用 DENY 精準控管 LinkServer 時
權限已混亂，需要快速止血

流程步驟

1. 確認目前 LinkServer 登入設定

使用 sp_helplinkedsrvlogin 檢視 mapping
可以看到誰對應哪個遠端帳號
判斷是否有 NULL（代表所有人共用）

EXEC sp_helplinkedsrvlogin;

2. 移除目標使用者的既有 mapping

針對所有 LinkServer
刪除該 User 的登入對應
避免舊設定干擾

EXEC sp_droplinkedsrvlogin
    @rmtsrvname = N'LinkServerName',
    @locallogin = N'UserA';

3. 建立「假帳號」強制登入失敗

核心做法：指定一組不存在的帳號
當 User 呼叫 LinkServer 時 → 一定登入失敗
等同「軟性 DENY」

EXEC sp_addlinkedsrvlogin
    @rmtsrvname = N'LinkServerName',
    @useself = N'False',
    @locallogin = N'UserA',
    @rmtuser = N'FakeDenyUser',
    @rmtpassword = N'WrongPassword';

補充

沒有 DENY USE LINKSERVER 這種權限，只能用 mapping 控制
@locallogin = NULL 代表所有人共用，需特別注意覆蓋順序
此方法不影響其他使用者（只針對指定帳號）

指令 / 範例整理

<details> <summary>Click to expand</summary>

-- 檢視權限
EXEC sp_helplinkedsrvlogin;

-- 動態產生：刪除 + 建立 Fake Mapping
DECLARE @UserName sysname = N'UserA';
DECLARE @FakeUser sysname = N'FakeDenyUser';
DECLARE @FakePassword nvarchar(200) = N'WrongPassword';

DECLARE @SQL nvarchar(max) = N'';

-- 1. 刪除 mapping
SELECT
    @SQL = @SQL +
    N'BEGIN TRY
        EXEC sp_droplinkedsrvlogin
            @rmtsrvname = N''' + REPLACE(name, '''', '''''') + ''',
            @locallogin = N''' + REPLACE(@UserName, '''', '''''') + ''';
    END TRY
    BEGIN CATCH
    END CATCH;' + CHAR(13) + CHAR(10)
FROM sys.servers
WHERE is_linked = 1;

-- 2. 建立 Fake mapping
SELECT
    @SQL = @SQL +
    N'EXEC sp_addlinkedsrvlogin
        @rmtsrvname = N''' + REPLACE(name, '''', '''''') + ''',
        @useself = N''False'',
        @locallogin = N''' + REPLACE(@UserName, '''', '''''') + ''',
        @rmtuser = N''' + REPLACE(@FakeUser, '''', '''''') + ''',
        @rmtpassword = N''' + REPLACE(@FakePassword, '''', '''''') + ''';'
    + CHAR(13) + CHAR(10)
FROM sys.servers
WHERE is_linked = 1;

-- Debug
PRINT @SQL;

-- 執行
EXEC sp_executesql @SQL;

</details>

收尾

LinkServer 沒有權限控管？那就用「讓他永遠連不上」這招，乾脆俐落。實務建議：權限設計一開始就分帳號，不然後面都只能補破網。

Azure SQL 怎麼一次備份全部 DB？PowerShell 自動匯出 bacpac

Wed, 08 Apr 2026 00:00:00 GMT

結論

這支腳本透過 DatabaseName 參數控制匯出範圍：有填值時只匯出指定 DB，空值時自動匯出整台 Azure SQL Server 下所有使用者 DB。

適合用在哪裡

想先測試單一 DB 匯出是否正常
想一次備份整台 Azure SQL Server 的所有使用者 DB
想把備份流程做成可重複執行的 PowerShell 腳本
想保留每次匯出結果與錯誤訊息，方便後續追查

流程步驟

1. 先定義參數與登入資訊

先準備 Azure 資源名稱、Storage 位置、SQL Admin 帳號，並加入 DatabaseName 參數。這個參數是整篇重點：空值代表全部 DB，有值代表單一指定 DB。接著輸入 SQL Admin 密碼，並抓出 Storage Account Key，後面匯出 bacpac 會用到。

# ===== 基本參數 =====
$ResourceGroupName   = "your-rg"
$ServerName          = "your-sql-server"
$DatabaseName        = ""   # 空值 = 全部 DB；有值 = 指定單一 DB
$StorageAccountName  = "yourstorageacct"
$ContainerName       = "sql-backup"
$SqlAdminLogin       = "your_sql_admin"

# 會跳出輸入框，請輸入 Azure SQL admin 密碼
$SqlAdminPassword = Read-Host "Enter Azure SQL admin password" -AsSecureString

# 取得 Storage Account Key
$StorageKey = (Get-AzStorageAccountKey `
    -ResourceGroupName $ResourceGroupName `
    -Name $StorageAccountName)[0].Value

2. 依 DatabaseName 決定要跑哪些 DB

這一步只處理清單，不做匯出。若 DatabaseName 是空值，就抓整台 logical server 底下所有資料庫，並排除 master；若有值，就只建立單一 DB 清單。這樣後面的匯出流程可共用，不必寫兩份腳本。

if ([string]::IsNullOrWhiteSpace($DatabaseName)) {
    # 抓出此 logical server 底下的資料庫，排除 master
    $databases = Get-AzSqlDatabase `
        -ResourceGroupName $ResourceGroupName `
        -ServerName $ServerName |
        Where-Object { $_.DatabaseName -ne "master" }
}
else {
    # 若有指定 DB，則只建立單一清單
    $databases = @(
        [PSCustomObject]@{
            DatabaseName = $DatabaseName
        }
    )
}

3. 逐一匯出 bacpac 到 Blob Storage

每個 DB 都加上時間戳記，避免同名檔被覆蓋。接著呼叫 New-AzSqlDatabaseExport 送出匯出請求，把 bacpac 寫到指定的 Blob Container。這段是核心，也是最實用的一段。

# 建立結果紀錄
$results = @()

foreach ($db in $databases) {
    $CurrentDatabaseName = $db.DatabaseName
    $TimeStamp = Get-Date -Format "yyyyMMdd-HHmmss"
    $BacpacFileName = "$CurrentDatabaseName-$TimeStamp.bacpac"
    $StorageUri = "<https://$StorageAccountName.blob.core.windows.net/$ContainerName/$BacpacFileName>"

    Write-Host "Starting export for $CurrentDatabaseName ..."

    try {
        $exportRequest = New-AzSqlDatabaseExport `
            -ResourceGroupName $ResourceGroupName `
            -ServerName $ServerName `
            -DatabaseName $CurrentDatabaseName `
            -StorageKeyType "StorageAccessKey" `
            -StorageKey $StorageKey `
            -StorageUri $StorageUri `
            -AdministratorLogin $SqlAdminLogin `
            -AdministratorLoginPassword $SqlAdminPassword

4. 持續查詢狀態並整理結果

匯出不是同步完成，所以要用 Get-AzSqlDatabaseImportExportStatus 輪詢狀態。完成後把每個 DB 的狀態、輸出位置與錯誤訊息收進結果表，最後統一輸出。這樣就不會只看到某個 DB 卡住，卻不知道其他 DB 的情況。

        # 輪詢匯出狀態
        do {
            Start-Sleep -Seconds 15
            $status = Get-AzSqlDatabaseImportExportStatus `
                -OperationStatusLink $exportRequest.OperationStatusLink

            Write-Host "$CurrentDatabaseName => $($status.Status)"
        } while ($status.Status -eq "InProgress")

        $results += [PSCustomObject]@{
            DatabaseName = $CurrentDatabaseName
            Status       = $status.Status
            StorageUri   = $StorageUri
            ErrorMessage = $status.ErrorMessage
        }
    }
    catch {
        $results += [PSCustomObject]@{
            DatabaseName = $CurrentDatabaseName
            Status       = "Failed"
            StorageUri   = $StorageUri
            ErrorMessage = $_.Exception.Message
        }
    }
}

$results | Format-Table -AutoSize

補充

master 建議直接排除，通常沒有備份成 bacpac 的實際價值
建議用 $CurrentDatabaseName，不要在 foreach 裡覆蓋原始 $DatabaseName 參數，後續比較不會亂
若遇到 schema 不支援、跨 DB 參照、外部物件等問題，匯出失敗多半是 bacpac 限制，不是 PowerShell 語法錯

指令 / 範例整理

<details> <summary>Click to expand</summary>

# 安裝 Az PowerShell 模組
Install-Module -Name Az -Scope CurrentUser

# 匯入 Az 模組
Import-Module Az

# 登入 Azure
Connect-AzAccount

# ===== 基本參數 =====
$ResourceGroupName   = "your-rg"
$ServerName          = "your-sql-server"
$DatabaseName        = ""   # 空值 = 全部 DB；有值 = 指定單一 DB
$StorageAccountName  = "yourstorageacct"
$ContainerName       = "sql-backup"
$SqlAdminLogin       = "your_sql_admin"

# 會跳出輸入框，請輸入 Azure SQL admin 密碼
$SqlAdminPassword = Read-Host "Enter Azure SQL admin password" -AsSecureString

# 取得 Storage Account Key
$StorageKey = (Get-AzStorageAccountKey `
    -ResourceGroupName $ResourceGroupName `
    -Name $StorageAccountName)[0].Value

# 抓取 DB 清單：空值 = 全部 DB；有值 = 單一 DB
if ([string]::IsNullOrWhiteSpace($DatabaseName)) {
    $databases = Get-AzSqlDatabase `
        -ResourceGroupName $ResourceGroupName `
        -ServerName $ServerName |
        Where-Object { $_.DatabaseName -ne "master" }
}
else {
    $databases = @(
        [PSCustomObject]@{
            DatabaseName = $DatabaseName
        }
    )
}

# 建立結果紀錄
$results = @()

foreach ($db in $databases) {
    $CurrentDatabaseName = $db.DatabaseName
    $TimeStamp = Get-Date -Format "yyyyMMdd-HHmmss"
    $BacpacFileName = "$CurrentDatabaseName-$TimeStamp.bacpac"
    $StorageUri = "<https://$StorageAccountName.blob.core.windows.net/$ContainerName/$BacpacFileName>"

    Write-Host "Starting export for $CurrentDatabaseName ..."

    try {
        $exportRequest = New-AzSqlDatabaseExport `
            -ResourceGroupName $ResourceGroupName `
            -ServerName $ServerName `
            -DatabaseName $CurrentDatabaseName `
            -StorageKeyType "StorageAccessKey" `
            -StorageKey $StorageKey `
            -StorageUri $StorageUri `
            -AdministratorLogin $SqlAdminLogin `
            -AdministratorLoginPassword $SqlAdminPassword

        # 輪詢匯出狀態
        do {
            Start-Sleep -Seconds 15
            $status = Get-AzSqlDatabaseImportExportStatus `
                -OperationStatusLink $exportRequest.OperationStatusLink

            Write-Host "$CurrentDatabaseName => $($status.Status)"
        } while ($status.Status -eq "InProgress")

        $results += [PSCustomObject]@{
            DatabaseName = $CurrentDatabaseName
            Status       = $status.Status
            StorageUri   = $StorageUri
            ErrorMessage = $status.ErrorMessage
        }
    }
    catch {
        $results += [PSCustomObject]@{
            DatabaseName = $CurrentDatabaseName
            Status       = "Failed"
            StorageUri   = $StorageUri
            ErrorMessage = $_.Exception.Message
        }
    }
}

# 顯示結果
$results | Format-Table -AutoSize

# ===== 補充查詢 / 驗證指令 =====

# 查詢某台 SQL Server 底下所有 DB
Get-AzSqlDatabase `
    -ResourceGroupName "your-rg" `
    -ServerName "your-sql-server"

# 查詢指定 DB
Get-AzSqlDatabase `
    -ResourceGroupName "your-rg" `
    -ServerName "your-sql-server" `
    -DatabaseName "your-db-name"

# 查詢 Storage Account Key
Get-AzStorageAccountKey `
    -ResourceGroupName "your-rg" `
    -Name "yourstorageacct"

# 建立 Storage Context
$ctx = New-AzStorageContext `
    -StorageAccountName "yourstorageacct" `
    -StorageAccountKey "your-storage-key"

# 查詢 Blob Container 是否存在
Get-AzStorageContainer `
    -Name "sql-backup" `
    -Context $ctx

# 建立 Blob Container
New-AzStorageContainer `
    -Name "sql-backup" `
    -Context $ctx

# 手動測試單一 DB 匯出
$DatabaseName = "appdb"

# 手動切換成匯出全部 DB
$DatabaseName = ""

# 手動查某次匯出狀態
Get-AzSqlDatabaseImportExportStatus `
    -OperationStatusLink "貼上 OperationStatusLink"

# 查看匯出後的 bacpac 檔案
Get-AzStorageBlob `
    -Container "sql-backup" `
    -Context $ctx

</details>

收尾

這版不是多高深，就是把該放一起的指令一次收齊；之後你要單檔測試、全站備份、接排程，都比較不會再來回補洞。

Git fetch/pull 爆錯？大小寫分支衝突完整解法

Tue, 31 Mar 2026 00:00:00 GMT

結論

用指令找出大小寫衝突 → 保留一個 → 刪除多餘分支，就能解掉 Git fetch/pull 卡死問題

適合用在哪裡

Windows / Mac 開發者遇到 Git pull 失敗
團隊有 Linux + Windows 混用
分支命名沒有統一規範
CI/CD 突然抓不到分支

流程步驟

1. 找出大小寫衝突分支

用 git ls-remote 抓遠端 branch，轉小寫後分組比對
核心是找「名稱不同但小寫後相同」的分支

git ls-remote --heads origin |
ForEach-Object { ($_ -split "`t")[1] } |
Group-Object { $_.ToLower() } |
Where-Object { $_.Count -gt 1 } |
Select-Object -ExpandProperty Group

👉 這步是關鍵，沒找出衝突就無法處理

2. 決定保留分支

通常統一為小寫（如 feature/login）
或依團隊規範決定 👉 Git 在 Windows 上不分大小寫，所以只能留一個

3. 刪除多餘分支

刪除遠端衝突分支

git push origin --delete Feature/Login

刪除後記得同步本地

git fetch --prune

👉 prune 很重要，不然本地還會殘留舊資料

補充

Windows / Mac 預設是不分大小寫檔案系統，Linux 是分大小寫 → 衝突來源
不建議用 reftable 解法，工具支援還不穩
CI/CD 若綁錯分支，刪除前要先確認 pipeline

指令 / 範例整理

<details> <summary>Click to expand</summary>

# 找出大小寫衝突
git ls-remote --heads origin |
ForEach-Object { ($_ -split "`t")[1] } |
Group-Object { $_.ToLower() } |
Where-Object { $_.Count -gt 1 } |
Select-Object -ExpandProperty Group

# 自訂 function
function Find-GitCaseConflict {
    git ls-remote --heads origin |
    ForEach-Object { ($_ -split "`t")[1] } |
    Group-Object { $_.ToLower() } |
    Where-Object { $_.Count -gt 1 } |
    Select-Object -ExpandProperty Group
}

# 刪除遠端分支
git push origin --delete Feature/Login

# 清理本地
git fetch --prune

</details>

收尾

Git 分支大小寫不統一，就是定時炸彈
建議一開始就規範命名（全小寫），後面會少很多坑

別再手動給權限了！用這套 SQL 角色設計讓管理變簡單

Thu, 26 Mar 2026 00:00:00 GMT

結論

用「自訂角色 + 內建角色」組合管理 SQL Server 權限，比直接對使用者 GRANT 更穩，也更容易維護。

適合用在哪裡

資料庫使用者越來越多，權限開始失控
新人、廠商、支援人員需要不同層級的 DB 權限
想把權限管理做成固定模板，而不是每次手動重配
希望降低直接對 User 給權限造成的追蹤困難

流程步驟

1. 先把角色模型定下來

先不要急著對人給權限，先定義三種標準角色：唯讀、一般開發、可改 Schema 的進階開發。這樣做的重點不是「分很多角色」，而是把常見需求收斂成固定模板，之後新增人員只要加到對應角色就好。實務上我會把命名統一成 role_db_*，一眼就知道這是自訂角色，不會跟內建角色混在一起。

IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = 'role_db_readonly')
    CREATE ROLE role_db_readonly;

IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = 'role_db_developer')
    CREATE ROLE role_db_developer;

IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = 'role_db_schema_developer')
    CREATE ROLE role_db_schema_developer;
GO

2. 用內建角色拼出權限模板

建完自訂角色後，再把內建角色的能力掛進去。role_db_readonly 給查詢與檢視定義，適合報表或查詢人員；role_db_developer 再加上寫入與執行 SP 的能力，適合一般後端工程師。這樣做的好處是層級很清楚，權限差異也看得出來，不會每個人都一套特規。

ALTER ROLE db_datareader ADD MEMBER role_db_readonly;
GRANT VIEW DEFINITION TO role_db_readonly;
GO

ALTER ROLE db_datareader ADD MEMBER role_db_developer;
ALTER ROLE db_datawriter ADD MEMBER role_db_developer;
GRANT EXECUTE ON SCHEMA::dbo TO role_db_developer;
GRANT VIEW DEFINITION TO role_db_developer;
GO

3. 進階角色只留給真的需要的人

role_db_schema_developer 可以再加上 db_ddladmin，讓角色具備 CREATE / ALTER / DROP 這類 DDL 能力。這類權限很方便，但也很容易手滑出事，所以不要因為「比較省事」就亂發。通常只建議給 Tech Lead、DBA，或真的需要調整物件結構的人。

ALTER ROLE db_datareader ADD MEMBER role_db_schema_developer;
ALTER ROLE db_datawriter ADD MEMBER role_db_schema_developer;
ALTER ROLE db_ddladmin ADD MEMBER role_db_schema_developer;

GRANT EXECUTE ON SCHEMA::dbo TO role_db_schema_developer;
GRANT VIEW DEFINITION TO role_db_schema_developer;
GO

4. 最後只管角色，不直接管人

權限模型定好後，使用者只要加入角色即可。關鍵原則很簡單：不要直接對 User 發權限。你今天直接 GRANT SELECT TO user1，明天就很難知道這個人到底為什麼有權限；但如果是加進 role_db_readonly，整個權限來源就很清楚。權限管理本質上不是發散，而是收斂，這句話不是裝深沉，是真的能救命 =_=

-- 將使用者加入對應角色
-- ALTER ROLE role_db_readonly ADD MEMBER [user1];
-- ALTER ROLE role_db_developer ADD MEMBER [user2];
-- ALTER ROLE role_db_schema_developer ADD MEMBER [user3];
GO

-- 不建議：直接對使用者給權限
GRANT SELECT TO user1;

-- 建議：把使用者加進角色
ALTER ROLE role_db_readonly ADD MEMBER user1;

指令 / 範例整理

角色與權限對照表

角色名稱	權限內容	適用對象
role_db_readonly	查詢、檢視定義	報表、查詢、支援
role_db_developer	查詢、寫入、執行、檢視定義	後端工程師、API 開發
role_db_schema_developer	查詢、寫入、執行、DDL、檢視定義	Tech Lead、DBA

SQL Agent 補充權限

很多人以為加了資料庫權限就能看 SQL Agent Job，結果打開一片空白，然後開始懷疑人生。這不是 SQL Server 壞掉，而是 **SQL Agent 權限在 ****msdb**，要另外補。 | 需求 | msdb 角色 | | --- | --- | | 只看自己的 Job | SQLAgentUserRole | | 看全部 Job / History | SQLAgentReaderRole | | 看全部且可操作 Job | SQLAgentOperatorRole |

USE msdb;
GO
ALTER ROLE SQLAgentUserRole ADD MEMBER [YourLogin];
GO

USE msdb;
GO
ALTER ROLE SQLAgentReaderRole ADD MEMBER [YourLogin];
GO

USE msdb;
GO
ALTER ROLE SQLAgentOperatorRole ADD MEMBER [YourLogin];
GO

補充

GRANT EXECUTE ON SCHEMA::dbo 只涵蓋 dbo schema；若你的 SP 不在 dbo，要另外補授權。
db_ddladmin 很強，但不等於完整 DBA；它偏向物件結構調整，不是所有管理權限都包含。
若系統已經存在大量直接對 User 的授權，建議先盤點再慢慢收斂，不要一次硬切，否則很容易炸。

收尾

把權限做成角色模板，之後維護的就不是一堆人，而是一套規則；規則穩了，系統才不會天天鬧脾氣。

VPN 連上卻連不到內網？其實是 Route 把你帶錯路

Wed, 25 Mar 2026 00:00:00 GMT

結論

VPN 連不上內網，多半不是壞掉，而是 route 導錯路，刪掉錯誤路由即可恢復

適合用在哪裡

VPN 已連線但無法連 DB / 內網主機
ping 不通但 DNS 正常解析
Azure / 公司內網混合環境
Windows 環境排查網路問題

流程步驟

1. 確認目前路由狀態

執行 route print 查看 routing table
找出目標 IP 是否被導向 VPN gateway
如果看到 /32 單一 IP 指向 VPN，多半就是問題來源

route print

👉 重點不是「有沒有 route」，而是「走去哪」

2. 判斷是否被 VPN 導錯

確認目標 IP（例如 10.x.x.x）是否本來應走 LAN
若 route 指向 VPN gateway，代表流量被強制帶錯路
常見情境：split tunnel 設錯或 VPN 推送錯誤 route 👉 DNS 正常但連不到，通常就是這種問題

3. 刪除錯誤 route（快速解法）

直接刪掉指定 IP route
Windows 會重新選擇最佳路徑（通常回到 LAN）

route delete 10.1.1.10
route delete 10.1.1.11

👉 刪掉後重新 ping / 連線，多半立即恢復

4.（選用）手動修正路由

若 VPN 會一直覆蓋，可手動加正確 route
指定走本地 gateway，避免再被搶走

route add 10.1.1.10 mask 255.255.255.255 192.168.1.1 metric 1

👉 metric 越低優先權越高，用來「壓過 VPN」

補充

nslookup 正常 ≠ 連線正常
VPN 常會推 /32 精準路由，很容易踩雷
重開 VPN 可能會把錯誤 route 加回來

指令 / 範例整理

# 查看路由
route print

# 刪除錯誤 route
route delete 10.1.1.10

# 手動指定正確路由
route add 10.1.1.10 mask 255.255.255.255 192.168.1.1 metric 1

收尾

網路不通，很多時候不是壞，是走錯路
先看 route，再懷疑世界，效率會高很多

SQL Agent 多 Job 匯出怎麼做：一支腳本重建多個排程與 Step

Tue, 24 Mar 2026 00:00:00 GMT

結論

用一支腳本批次匯出並重建 SQL Agent Job，連 step、schedule、通知一起帶走，省時間又避免漏設定。

適合用在哪裡

DB 搬機 / 環境切換（DEV → UAT → PROD）
多個 SQL Agent Job 要同步重建
想避免手動建立 Job 遺漏 step 或 schedule
DBA / 後端工程師做維運自動化

流程步驟

1. 定義參數與 Job 清單

先集中管理會變動的設定（DB、Owner、是否覆蓋），再用表變數定義要匯出的 Job 名單，支援改名。這樣做可以一次處理多個 Job，不用重複操作。

DECLARE @OverrideDatabaseName SYSNAME = N'你的新DB'; -- 指定新 DB
DECLARE @OverrideOwnerLoginName SYSNAME = N'sa';     -- 指定 owner

INSERT INTO @Jobs (SourceJobName, TargetJobName)
VALUES
    (N'Job_A', N'Job_A_New'),
    (N'Job_B', NULL);

2. 先做檢查，避免匯出錯誤

在產生腳本前先驗證來源 Job 是否存在，以及目標名稱是否重複。這能避免搬到一半才發現錯誤。

IF EXISTS (
    SELECT 1
    FROM @Jobs j
    LEFT JOIN msdb.dbo.sysjobs sj
        ON sj.name = j.SourceJobName
    WHERE sj.job_id IS NULL
)
BEGIN
    RAISERROR(N'Job 不存在', 16, 1);
    RETURN;
END;

3. 動態組出 Job / Step / Schedule

透過系統表 msdb.dbo.sysjobs、sysjobsteps、sysschedules，逐一組出完整腳本。這樣重建後的 Job 行為會與原本一致。

EXEC msdb.dbo.sp_add_job
    @job_name = N'Job_A_New',
    @enabled = 1;

EXEC msdb.dbo.sp_add_jobstep
    @job_id = @jobId,
    @step_name = N'Step1',
    @command = N'SELECT 1;',
    @database_name = N'你的新DB';

4. 輸出 Warning 與檢查資訊

腳本會額外標示風險，例如非 TSQL step、Proxy、寫死 DB 名稱等，讓你在部署前能先檢查。

-- WARNING: 非 TSQL step
-- WARNING: 使用 Proxy
-- WARNING: command 可能寫死 DB

補充

command 內若寫死 DB 名稱，腳本不會自動改，需手動調整
Proxy / SSIS / PowerShell step 要先在新環境建立對應設定
正式環境建議不要直接覆蓋 Job，先確認再執行

指令 / 範例整理

<details> <summary>Click to expand</summary>

USE msdb;
GO

SET NOCOUNT ON;

-------------------------------------------------------------------------------
-- 參數區
-------------------------------------------------------------------------------
DECLARE @OverrideDatabaseName SYSNAME = N'你的新DB';   -- NULL = 不覆蓋 step database_name
DECLARE @OverrideOwnerLoginName SYSNAME = N'sa';       -- NULL = 沿用原 owner
DECLARE @OverrideOperatorName SYSNAME = NULL;          -- NULL = 沿用原 operator
DECLARE @DropIfExists BIT = 1;                         -- 1=若同名 Job 已存在，先刪除再重建
DECLARE @AttachToLocalServer BIT = 1;                  -- 1=最後執行 sp_add_jobserver 綁到 (LOCAL)

DECLARE @CRLF NVARCHAR(10) = CHAR(13) + CHAR(10) + '/**/';
DECLARE @FinalSQL NVARCHAR(MAX) = N'';
DECLARE @Header NVARCHAR(MAX) = N'';

-------------------------------------------------------------------------------
-- 指定要匯出的 Jobs
-------------------------------------------------------------------------------
DECLARE @Jobs TABLE
(
    RowNum INT IDENTITY(1,1) PRIMARY KEY,
    SourceJobName SYSNAME NOT NULL,
    TargetJobName SYSNAME NULL
);

-- ===== 在這裡填你要匯出的 Jobs =====
INSERT INTO @Jobs (SourceJobName, TargetJobName)
VALUES
    (N'Job_A', N'Job_A_New'),
    (N'Job_B', NULL),
    (N'Job_C', N'Job_C_New');
-- ==================================

-------------------------------------------------------------------------------
-- 基本檢查：來源 Job 是否存在
-------------------------------------------------------------------------------
IF EXISTS
(
    SELECT 1
    FROM @Jobs j
    LEFT JOIN msdb.dbo.sysjobs sj
        ON sj.name = j.SourceJobName
    WHERE sj.job_id IS NULL
)
BEGIN
    SELECT
        j.SourceJobName
    FROM @Jobs j
    LEFT JOIN msdb.dbo.sysjobs sj
        ON sj.name = j.SourceJobName
    WHERE sj.job_id IS NULL;

    RAISERROR(N'上面列出的 SourceJobName 在 msdb.dbo.sysjobs 中找不到，請先修正。', 16, 1);
    RETURN;
END;

-------------------------------------------------------------------------------
-- 檢查 TargetJobName 是否重複
-------------------------------------------------------------------------------
IF EXISTS
(
    SELECT 1
    FROM
    (
        SELECT ISNULL(TargetJobName, SourceJobName) AS FinalJobName
        FROM @Jobs
    ) x
    GROUP BY x.FinalJobName
    HAVING COUNT(*) > 1
)
BEGIN
    SELECT
        x.FinalJobName,
        COUNT(*) AS Cnt
    FROM
    (
        SELECT ISNULL(TargetJobName, SourceJobName) AS FinalJobName
        FROM @Jobs
    ) x
    GROUP BY x.FinalJobName
    HAVING COUNT(*) > 1;

    RAISERROR(N'上面列出的 TargetJobName / FinalJobName 有重複，會互相覆蓋，請先修正。', 16, 1);
    RETURN;
END;

-------------------------------------------------------------------------------
-- Header
-------------------------------------------------------------------------------
SET @Header =
N'/* =====================================================================' + @CRLF +
N'   SQL Agent Multi-Job Export Script' + @CRLF +
N'   Generated  : ' + CONVERT(NVARCHAR(19), GETDATE(), 120) + @CRLF +
N'   Notes:' + @CRLF +
N'   1. 請先確認新環境是否存在對應 Login / Operator / Proxy / Database。' + @CRLF +
N'   2. 若 step command 內文有寫死舊 DB，需人工調整。' + @CRLF +
N'   3. 建議先建立後停用 Job，手動測試 step 無誤再啟用 schedule。' + @CRLF +
N'===================================================================== */' + @CRLF + @CRLF;

SET @FinalSQL = @Header;

-------------------------------------------------------------------------------
-- 先準備待處理 Job 清單
-------------------------------------------------------------------------------
DECLARE @JobList TABLE
(
    RowNum INT PRIMARY KEY,
    SourceJobName SYSNAME NOT NULL,
    TargetJobName SYSNAME NOT NULL,
    JobId UNIQUEIDENTIFIER NOT NULL
);

INSERT INTO @JobList (RowNum, SourceJobName, TargetJobName, JobId)
SELECT
    j.RowNum,
    j.SourceJobName,
    ISNULL(j.TargetJobName, j.SourceJobName) AS TargetJobName,
    sj.job_id
FROM @Jobs j
JOIN msdb.dbo.sysjobs sj
    ON sj.name = j.SourceJobName;

-------------------------------------------------------------------------------
-- 逐一組 Script
-------------------------------------------------------------------------------
DECLARE
    @RowNum INT,
    @SourceJobName SYSNAME,
    @TargetJobName SYSNAME,
    @JobId UNIQUEIDENTIFIER,
    @JobSQL NVARCHAR(MAX),
    @Warnings NVARCHAR(MAX),
    @Tmp NVARCHAR(MAX);

DECLARE JobCursor CURSOR FAST_FORWARD FOR
SELECT RowNum, SourceJobName, TargetJobName, JobId
FROM @JobList
ORDER BY RowNum;

OPEN JobCursor;
FETCH NEXT FROM JobCursor INTO @RowNum, @SourceJobName, @TargetJobName, @JobId;

WHILE @@FETCH_STATUS = 0
BEGIN
    SET @JobSQL = N'';
    SET @Warnings = N'';
    SET @Tmp = N'';

    ---------------------------------------------------------------------------
    -- Job 區塊標頭
    ---------------------------------------------------------------------------
    SET @JobSQL = @JobSQL +
    N'/* =====================================================================' + @CRLF +
    N'   Job #' + CAST(@RowNum AS NVARCHAR(10)) + N'' + @CRLF +
    N'   Source Job : ' + REPLACE(@SourceJobName, '*/', '* /') + @CRLF +
    N'   Target Job : ' + REPLACE(@TargetJobName, '*/', '* /') + @CRLF +
    N'===================================================================== */' + @CRLF + @CRLF;

    ---------------------------------------------------------------------------
    -- Warning 區
    ---------------------------------------------------------------------------
    IF EXISTS (
        SELECT 1
        FROM msdb.dbo.sysjobsteps
        WHERE job_id = @JobId
        GROUP BY job_id
        HAVING COUNT(*) > 1
    )
    BEGIN
        SET @Warnings = @Warnings + N'-- WARNING: 此 Job 含多個 steps，請逐一確認 step 間跳轉。' + @CRLF;
    END;

    IF EXISTS (
        SELECT 1
        FROM msdb.dbo.sysjobsteps
        WHERE job_id = @JobId
          AND subsystem <> N'TSQL'
    )
    BEGIN
        SET @Warnings = @Warnings + N'-- WARNING: 含非 TSQL steps（如 CmdExec / PowerShell / SSIS），新環境需確認元件與權限。' + @CRLF;
    END;

    IF EXISTS (
        SELECT 1
        FROM msdb.dbo.sysjobsteps
        WHERE job_id = @JobId
          AND proxy_id IS NOT NULL
          AND proxy_id <> 0
    )
    BEGIN
        SET @Warnings = @Warnings + N'-- WARNING: 此 Job 使用 Proxy，新環境必須先建立對應 Proxy/Credential。' + @CRLF;
    END;

    IF EXISTS (
        SELECT 1
        FROM msdb.dbo.sysjobsteps
        WHERE job_id = @JobId
          AND (
                command LIKE N'%USE [%]%'
             OR command LIKE N'%].dbo.%'
             OR command LIKE N'%.dbo.%'
          )
    )
    BEGIN
        SET @Warnings = @Warnings + N'-- WARNING: 某些 step command 可能寫死資料庫名稱，請人工檢查 command 內容。' + @CRLF;
    END;

    IF @Warnings <> N''
    BEGIN
        SET @JobSQL = @JobSQL +
        N'/* Pre-check warnings */' + @CRLF +
        @Warnings + @CRLF;
    END;

    ---------------------------------------------------------------------------
    -- 刪除同名 Job（可選）
    ---------------------------------------------------------------------------
    SET @JobSQL = @JobSQL +
    N'USE msdb;' + @CRLF +
    N'GO' + @CRLF;

    IF @DropIfExists = 1
    BEGIN
        SET @JobSQL = @JobSQL +
        N'IF EXISTS (SELECT 1 FROM msdb.dbo.sysjobs WHERE name = N''' + REPLACE(@TargetJobName, '''', '''''') + N''')' + @CRLF +
        N'BEGIN' + @CRLF +
        N'    EXEC msdb.dbo.sp_delete_job @job_name = N''' + REPLACE(@TargetJobName, '''', '''''') + N''';' + @CRLF +
        N'END' + @CRLF +
        N'GO' + @CRLF;
    END;

    SET @JobSQL = @JobSQL +
    N'DECLARE @jobId BINARY(16);' + @CRLF + @CRLF;

    ---------------------------------------------------------------------------
    -- sp_add_job
    ---------------------------------------------------------------------------
    SELECT @Tmp =
    N'EXEC msdb.dbo.sp_add_job' + @CRLF +
    N'    @job_name = N''' + REPLACE(@TargetJobName, '''', '''''') + N''',' + @CRLF +
    N'    @enabled = ' + CAST(j.enabled AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @notify_level_eventlog = ' + CAST(j.notify_level_eventlog AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @notify_level_email = ' + CAST(j.notify_level_email AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @notify_level_netsend = ' + CAST(j.notify_level_netsend AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @notify_level_page = ' + CAST(j.notify_level_page AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @delete_level = ' + CAST(j.delete_level AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @description = N''' + REPLACE(ISNULL(j.description, N''), '''', '''''') + N''',' + @CRLF +
    N'    @category_name = N''' + REPLACE(ISNULL(c.name, N'[Uncategorized (Local)]'), '''', '''''') + N''',' + @CRLF +
    N'    @owner_login_name = N''' + REPLACE(ISNULL(@OverrideOwnerLoginName, SUSER_SNAME(j.owner_sid)), '''', '''''') + N''',' + @CRLF +
    N'    @job_id = @jobId OUTPUT;' + @CRLF + @CRLF
    FROM msdb.dbo.sysjobs j
    LEFT JOIN msdb.dbo.syscategories c
        ON j.category_id = c.category_id
    WHERE j.job_id = @JobId;

    SET @JobSQL = @JobSQL + ISNULL(@Tmp, N'');

    ---------------------------------------------------------------------------
    -- Steps
    ---------------------------------------------------------------------------
    SET @Tmp = N'';

    SELECT @Tmp = @Tmp +
    N'EXEC msdb.dbo.sp_add_jobstep' + @CRLF +
    N'    @job_id = @jobId,' + @CRLF +
    N'    @step_id = ' + CAST(s.step_id AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @step_name = N''' + REPLACE(s.step_name, '''', '''''') + N''',' + @CRLF +
    N'    @subsystem = N''' + REPLACE(s.subsystem, '''', '''''') + N''',' + @CRLF +
    N'    @command = N''' + REPLACE(ISNULL(s.command, N''), '''', '''''') + N''',' + @CRLF +
    CASE
        WHEN s.additional_parameters IS NULL THEN N''
        ELSE N'    @additional_parameters = N''' + REPLACE(s.additional_parameters, '''', '''''') + N''',' + @CRLF
    END +
    N'    @cmdexec_success_code = ' + CAST(ISNULL(s.cmdexec_success_code, 0) AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @on_success_action = ' + CAST(s.on_success_action AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @on_success_step_id = ' + CAST(s.on_success_step_id AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @on_fail_action = ' + CAST(s.on_fail_action AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @on_fail_step_id = ' + CAST(s.on_fail_step_id AS NVARCHAR(10)) + N',' + @CRLF +
    CASE
        WHEN s.server IS NULL THEN N''
        ELSE N'    @server = N''' + REPLACE(s.server, '''', '''''') + N''',' + @CRLF
    END +
    N'    @database_name = ' +
        CASE
            WHEN ISNULL(@OverrideDatabaseName, s.database_name) IS NULL THEN N'NULL'
            ELSE N'N''' + REPLACE(ISNULL(@OverrideDatabaseName, s.database_name), '''', '''''') + N''''
        END + N',' + @CRLF +
    N'    @database_user_name = ' +
        CASE
            WHEN s.database_user_name IS NULL THEN N'NULL'
            ELSE N'N''' + REPLACE(s.database_user_name, '''', '''''') + N''''
        END + N',' + @CRLF +
    N'    @retry_attempts = ' + CAST(ISNULL(s.retry_attempts, 0) AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @retry_interval = ' + CAST(ISNULL(s.retry_interval, 0) AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @os_run_priority = ' + CAST(ISNULL(s.os_run_priority, 0) AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @output_file_name = ' +
        CASE
            WHEN s.output_file_name IS NULL THEN N'NULL'
            ELSE N'N''' + REPLACE(s.output_file_name, '''', '''''') + N''''
        END + N',' + @CRLF +
    CASE
        WHEN p.name IS NULL OR p.name = N'' THEN N''
        ELSE N'    @proxy_name = N''' + REPLACE(p.name, '''', '''''') + N''',' + @CRLF
    END +
    N'    @flags = ' + CAST(ISNULL(s.flags, 0) AS NVARCHAR(10)) + N';' + @CRLF + @CRLF
    FROM msdb.dbo.sysjobsteps s
    LEFT JOIN msdb.dbo.sysproxies p
        ON s.proxy_id = p.proxy_id
    WHERE s.job_id = @JobId
    ORDER BY s.step_id;

    SET @JobSQL = @JobSQL + ISNULL(@Tmp, N'');

    ---------------------------------------------------------------------------
    -- start_step_id
    ---------------------------------------------------------------------------
    SELECT @Tmp =
    N'EXEC msdb.dbo.sp_update_job' + @CRLF +
    N'    @job_id = @jobId,' + @CRLF +
    N'    @start_step_id = ' + CAST(j.start_step_id AS NVARCHAR(10)) + N';' + @CRLF + @CRLF
    FROM msdb.dbo.sysjobs j
    WHERE j.job_id = @JobId;

    SET @JobSQL = @JobSQL + ISNULL(@Tmp, N'');

    ---------------------------------------------------------------------------
    -- schedules
    ---------------------------------------------------------------------------
    SET @Tmp = N'';

    SELECT @Tmp = @Tmp +
    N'EXEC msdb.dbo.sp_add_jobschedule' + @CRLF +
    N'    @job_id = @jobId,' + @CRLF +
    N'    @name = N''' + REPLACE(sch.name, '''', '''''') + N''',' + @CRLF +
    N'    @enabled = ' + CAST(sch.enabled AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @freq_type = ' + CAST(sch.freq_type AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @freq_interval = ' + CAST(sch.freq_interval AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @freq_subday_type = ' + CAST(sch.freq_subday_type AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @freq_subday_interval = ' + CAST(sch.freq_subday_interval AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @freq_relative_interval = ' + CAST(sch.freq_relative_interval AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @freq_recurrence_factor = ' + CAST(sch.freq_recurrence_factor AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @active_start_date = ' + CAST(sch.active_start_date AS NVARCHAR(20)) + N',' + @CRLF +
    N'    @active_end_date = ' + CAST(sch.active_end_date AS NVARCHAR(20)) + N',' + @CRLF +
    N'    @active_start_time = ' + CAST(sch.active_start_time AS NVARCHAR(20)) + N',' + @CRLF +
    N'    @active_end_time = ' + CAST(sch.active_end_time AS NVARCHAR(20)) + N';' + @CRLF + @CRLF
    FROM
    (
        SELECT DISTINCT
            sch.name,
            sch.enabled,
            sch.freq_type,
            sch.freq_interval,
            sch.freq_subday_type,
            sch.freq_subday_interval,
            sch.freq_relative_interval,
            sch.freq_recurrence_factor,
            sch.active_start_date,
            sch.active_end_date,
            sch.active_start_time,
            sch.active_end_time
        FROM msdb.dbo.sysjobschedules js
        JOIN msdb.dbo.sysschedules sch
            ON js.schedule_id = sch.schedule_id
        WHERE js.job_id = @JobId
    ) sch
    ORDER BY sch.name;

    SET @JobSQL = @JobSQL + ISNULL(@Tmp, N'');

    ---------------------------------------------------------------------------
    -- operator / notify
    ---------------------------------------------------------------------------
    SELECT @Tmp =
    N'EXEC msdb.dbo.sp_update_job' + @CRLF +
    N'    @job_id = @jobId,' + @CRLF +
    N'    @notify_level_email = ' + CAST(j.notify_level_email AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @notify_level_netsend = ' + CAST(j.notify_level_netsend AS NVARCHAR(10)) + N',' + @CRLF +
    N'    @notify_level_page = ' + CAST(j.notify_level_page AS NVARCHAR(10)) +
    CASE
        WHEN ISNULL(@OverrideOperatorName, op_email.name) IS NOT NULL
            THEN N',' + @CRLF + N'    @notify_email_operator_name = N''' + REPLACE(ISNULL(@OverrideOperatorName, op_email.name), '''', '''''') + N''''
        ELSE N''
    END +
    CASE
        WHEN ISNULL(@OverrideOperatorName, op_netsend.name) IS NOT NULL
            THEN N',' + @CRLF + N'    @notify_netsend_operator_name = N''' + REPLACE(ISNULL(@OverrideOperatorName, op_netsend.name), '''', '''''') + N''''
        ELSE N''
    END +
    CASE
        WHEN ISNULL(@OverrideOperatorName, op_page.name) IS NOT NULL
            THEN N',' + @CRLF + N'    @notify_page_operator_name = N''' + REPLACE(ISNULL(@OverrideOperatorName, op_page.name), '''', '''''') + N''''
        ELSE N''
    END +
    N';' + @CRLF + @CRLF
    FROM msdb.dbo.sysjobs j
    LEFT JOIN msdb.dbo.sysoperators op_email
        ON j.notify_email_operator_id = op_email.id
    LEFT JOIN msdb.dbo.sysoperators op_netsend
        ON j.notify_netsend_operator_id = op_netsend.id
    LEFT JOIN msdb.dbo.sysoperators op_page
        ON j.notify_page_operator_id = op_page.id
    WHERE j.job_id = @JobId;

    SET @JobSQL = @JobSQL + ISNULL(@Tmp, N'');

    ---------------------------------------------------------------------------
    -- job server
    ---------------------------------------------------------------------------
    IF @AttachToLocalServer = 1
    BEGIN
        SET @JobSQL = @JobSQL +
        N'EXEC msdb.dbo.sp_add_jobserver' + @CRLF +
        N'    @job_id = @jobId,' + @CRLF +
        N'    @server_name = N''(LOCAL)'';' + @CRLF + @CRLF;
    END;

    ---------------------------------------------------------------------------
    -- step review
    ---------------------------------------------------------------------------
    SET @JobSQL = @JobSQL +
    N'/* Step Review' + @CRLF;

    SET @Tmp = N'';

    SELECT @Tmp = @Tmp +
    N'-- Step ' + CAST(s.step_id AS NVARCHAR(10)) +
    N' | Name: ' + REPLACE(REPLACE(s.step_name, CHAR(13), N' '), CHAR(10), N' ') +
    N' | Subsystem: ' + s.subsystem +
    N' | DB: ' + ISNULL(s.database_name, N'(NULL)') +
    N' | Proxy: ' + ISNULL(p.name, N'(NULL)') +
    CASE
        WHEN s.command LIKE N'%USE [%]%'
          OR s.command LIKE N'%].dbo.%'
          OR s.command LIKE N'%.dbo.%'
        THEN N' | CHECK_COMMAND_FOR_DB_NAME=YES'
        ELSE N''
    END +
    @CRLF
    FROM msdb.dbo.sysjobsteps s
    LEFT JOIN msdb.dbo.sysproxies p
        ON s.proxy_id = p.proxy_id
    WHERE s.job_id = @JobId
    ORDER BY s.step_id;

    SET @JobSQL = @JobSQL + ISNULL(@Tmp, N'') +
    N'*/' + @CRLF +
    N'GO' + @CRLF + @CRLF;

    ---------------------------------------------------------------------------
    -- 加到總腳本
    ---------------------------------------------------------------------------
    SET @FinalSQL = @FinalSQL + @JobSQL;

    FETCH NEXT FROM JobCursor INTO @RowNum, @SourceJobName, @TargetJobName, @JobId;
END

CLOSE JobCursor;
DEALLOCATE JobCursor;

-------------------------------------------------------------------------------
-- 最終輸出
-------------------------------------------------------------------------------
SELECT @FinalSQL AS DeployScript;
GO

</details>

收尾

這種腳本重點不是匯出，而是讓 Job 搬遷變成「可重複、可驗證」的流程。

SSMS 每次寫 SQL 都在補註解？用 Code Snippet 一鍵生成

Tue, 24 Mar 2026 00:00:00 GMT

結論

用 SSMS Code Snippet 建立註解模板，輸入 cmt 就能快速產生完整 SQL 註解結構。

適合用在哪裡

團隊需要統一 SQL 註解格式
常寫 Stored Procedure / Script
想減少重複貼模板的時間
想提升 SQL 可讀性與維護性

流程步驟

1. 建立 Snippet 檔案

將 XML 存成 .snippet 檔，放到指定路徑
路徑：

C:\\Users\\@User\\Documents\\SQL Server Management Studio 21\\Code Snippets\\SQL\\My Code Snippets

SSMS 會自動讀取這個資料夾內的 snippet（重開 SSMS 才會生效）

2. 設定 Snippet 結構

定義標題、快捷鍵（Shortcut）、變數（Literal）
Shortcut 設為 cmt，之後輸入 cmt + Tab 直接展開
變數像 $author$ 、 $date$ 可快速填值

<CodeSnippets xmlns="<http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet>">
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>SQL-Comment</Title>
      <Shortcut>cmt</Shortcut>
      <Description>SQL-Comment</Description>
      <Author>J</Author>
    </Header>

    <Snippet>
      <Code Language="SQL"><![CDATA[
-- =============================================
-- Author:      $author$
-- Create Date: $date$
-- Description: $desc$
-- =============================================
/*  Parameter:
        $param$

    SQL:
        $sql$

    Log:
        $log$
*/
]]></Code>

      <Declarations>
        <Literal>
          <ID>author</ID>
          <Default>YourName</Default>
        </Literal>

        <Literal>
          <ID>date</ID>
          <Default>yyyy/MM/dd</Default>
        </Literal>

        <Literal>
          <ID>desc</ID>
          <Default>Description</Default>
        </Literal>

        <Literal>
          <ID>param</ID>
          <Default>@Param Comment</Default>
        </Literal>

        <Literal>
          <ID>sql</ID>
          <Default>SQL Sample</Default>
        </Literal>

        <Literal>
          <ID>log</ID>
          <Default>yyyyMMdd by YourName - adjustment notes</Default>
        </Literal>
      </Declarations>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

3. 使用 Snippet

在 SSMS Query 視窗輸入：

cmt

按 Tab → 自動展開模板
再用 Tab 在各欄位間切換填值

補充

SSMS 不會即時 reload Snippet → 一定要重開
Shortcut 衝突時會無法展開（建議用簡短但不常見的名稱）
可建立多個 snippet（例如：sp、select、log 模板）

指令 / 範例整理

<details> <summary>Click to expend</summary>

展開 snippet：

cmt + Tab

</details>

收尾

懶不是問題，重複寫才是，Snippet 幫你把時間偷回來。

SSMS 匯入/匯出資料按鈕反灰？其實你少裝一個東西

Thu, 23 Oct 2025 00:00:00 GMT

結論

SSMS 匯入/匯出功能是靠 SSIS，沒裝就會直接鎖死

適合用在哪裡

SSMS 出現「匯入/匯出資料」反灰
點擊時提示版本不支援
新環境或重灌 SSMS 後功能消失

流程步驟

1. 確認問題現象

在 SSMS 中對資料庫右鍵 → 匯入資料 / 匯出資料
發現按鈕反灰或顯示不支援
這不是權限問題，而是工具缺失（常見誤判）

2. 安裝 SSIS（核心解法）

安裝 SQL Server Integration Services（SSIS）
SSMS 本身只是 UI，實際執行是 SSIS 在跑
沒裝 SSIS，就像有按鈕但沒引擎

3. 驗證功能恢復

重開 SSMS
再次右鍵 DB → 匯入/匯出資料
若可點擊，代表環境已完整

補充

SSMS 與 SSIS 是分開安裝的（很多人會以為內建）
安裝 SQL Server 時，需勾選 Integration Services 才會有
有些精簡版本（例如 Developer Tools Only）不會包含 SSIS

收尾

這問題不難，但很容易卡住半天，少裝就是少靈魂
新環境記得先確認 SSIS，有些坑踩一次就好

從 APK 到 EXE：我怎麼用 JADX 和 ChatGPT 把反編譯結果變成可執行工具

Thu, 04 Sep 2025 00:00:00 GMT

結論

這套流程很適合拿來快速理解 APK 內部邏輯、抽出可測試的程式片段，並逐步整理成可執行的 Python 工具。

流程很直白：先反編譯、再分析、持續測試、最後打包。

適合用在哪裡

想研究 APK 的程式邏輯
想把某段功能抽出來做本機驗證
想快速做成可執行工具給自己或同事使用

流程步驟

1. 使用 JADX 反編譯 APK 檔

JADX 可以把 APK 內容反編譯成較容易閱讀的 Java 原始碼，拿來理解程式流程很方便。

工具網址：https://github.com/skylot/jadx
常見用途：
- 查看 class 結構
- 找 API 呼叫流程
- 找加解密、參數組裝、驗證邏輯
- 追 UI 與業務邏輯的對應關係

2. 將相關檔案丟給 ChatGPT，產生 Python 檔案進行測試

從 JADX 找到需要的邏輯後，可以把關鍵程式碼、設定檔、流程片段整理出來，交給 ChatGPT 協助轉成 Python 測試版本。

這一步通常會做的事：

抽出核心邏輯
補齊缺少的參數
改寫成可直接執行的 Python 程式
降低原始專案環境依賴，方便單獨驗證

3. 不斷執行 → 測試 → 修改，直到測試成功

這段其實最花時間，但也是最重要的一段。

python your_file.py arg1

建議做法：

先讓程式能跑起來
再補齊缺少的邏輯
遇到錯誤就看 traceback 修正
每次只改一小段，比較好追問題

4. 打包成 `.exe` 檔

當 Python 測試完成後，就可以用 PyInstaller 打包成 EXE。

pip install pyinstaller
pyinstaller --onefile your_file.py

說明：

-onefile → 打包成單一 EXE 檔
輸出位置：dist/your_file.exe

5. 執行 EXE 檔

dist\\your_file.exe arg1

注意事項

1. 不要一開始就急著打包

先把 Python 版本測通，再進入打包。

2. 反編譯後的程式不一定完整

可能有混淆或缺少部分邏輯，需要自行補齊。

3. ChatGPT 適合做輔助

用來整理、改寫、補框架很快，但最終還是要自己測。

重點整理

階段	工具 / 做法	目的
反編譯 APK	JADX	讀取原始邏輯
邏輯整理	ChatGPT	轉成測試程式
執行驗證	Python	確認功能
打包發佈	PyInstaller	產出 EXE
最終執行	EXE	實際使用

指令總整理

python your_file.py arg1
pip install pyinstaller
pyinstaller --onefile your_file.py
dist\\your_file.exe arg1

收尾

這流程本質是：

拆 → 測 → 修 → 打包

前面像考古，後面像馴獸。

能跑起來的那一刻，會爽一下。

Google App Script 上架卡關？完整流程＋OAuth設定一次搞懂

Fri, 25 Jul 2025 00:00:00 GMT

引言

你如果寫了 Google App Script，想做成 Add-on 上架到 Google Workspace Marketplace，最容易卡的不是程式，而是 OAuth、部署 ID、審核流程。

這些設定分散又繁瑣，一不注意就被退件。

這篇整理完整 Google App Script 上架流程與 OAuth 設定，讓你一次走完，不再卡關。

🎯 目標說明

本篇將帶你完成：

建立 App Script 專案
設定 OAuth 同意畫面
測試 Add-on
發布至 Google Workspace Marketplace

核心流程（步驟拆解）

步驟一：建立 App Script 與部署

建立 App Script
開啟 appscript.json & 指定 GCP 專案編號
部署→新增部署
部署→測試部署 (開發測試)

步驟二：設定 OAuth 權限

設定 Branding（OAuth 同意畫面）

需填寫：

App Name：需與 Add-On 套件一致
App domain：需架設一個介紹網站，內容需包含隱私條件、服務條款 (可用自己的 domain / 放在 github.io)
Authorized domains：放 App domain 使用的網域

背後原理

Google 透過 OAuth 畫面驗證應用可信度
審核重點在這裡

步驟三：Marketplace 上架設定

啟用「Google Workspace Marketplace SDK」服務
兩個分頁內都需填寫：設定 App Scripts的部署ID、開發者資訊、商品資訊
商店資訊→瀏覽 MARKETPLACE：上架前測試。該頁填寫「草稿測試人員」的Mail
想測試還需要設定 OAuth 的測試：OAuth 同意畫面→目標對象→測試使用者 + Add
測試完回到「商店資訊」：送出審核
OAUTH 切換至 Production
最後~ 就等 GOOGLE 審核結果

⚠️ 常見問題 / 踩坑

OAuth 被退件

沒有隱私權政策
Domain 不一致

無法測試 Add-on

未加入測試使用者

上架失敗

Deployment ID 錯誤
OAuth 尚未 Production
文字使用到 GOOGLE的產品需加™ (e.g. Google Sheets™、Google Workspace™)

總結

這篇帶你走完：

App Script 建立與部署
OAuth 設定
Marketplace 上架流程關鍵重點：

OAuth 設定是最大關鍵
測試流程不能省
Marketplace 資訊要完整

Error: invalid version 16？SMO 抓不到語法直接炸掉

Fri, 25 Jul 2025 00:00:00 GMT

結論

SMO 版本過舊無法解析新版 SQL Server（v16），更新 SSMS 就能解。

適合用在哪裡

使用 SMO 取得 Table / View Script
自動化產生 SQL Schema
使用舊版 SSMS / 舊 SDK 的環境
出現 version 16 / 版本不支援錯誤

流程步驟

1. 確認錯誤來源（SMO 版本不支援）

執行取得 Create Table / View 語法時出現 invalid version 16
代表 SMO 無法識別 SQL Server 2022（v16）
常見於：
- 舊版 SSMS
- 舊版 NuGet：Microsoft.SqlServer.Smo

2. 更新 SSMS（最快解）

到微軟官方下載最新版 SSMS
安裝後會自動更新 SMO 相關元件
為什麼：
- SMO 版本跟 SSMS 綁在一起
- 新版 SSMS 才支援 SQL Server 2022+

3. （程式端）更新 NuGet 套件（如果有用 SMO）

更新 SMO 套件版本

# 更新 SMO 套件
dotnet add package Microsoft.SqlServer.SqlManagementObjects

確保版本 >= 支援 SQL Server 2022

補充

SSMS 跟 SQL Server 版本不需要一致，但不能太舊
SMO 很吃版本，不是 DB 問題，是 client 問題
若 CI/CD 有用 SMO，也要同步升級套件

收尾

看到 version 16 別懷疑人生，九成是工具太老，更新就好。

Azure Hybrid Connection 實戰：讓雲端安全連回地端服務

Fri, 25 Jul 2025 00:00:00 GMT

結論

用 Hybrid Connection 可以讓 Azure Web App 不開 VPN、不曝露 IP，直接安全連回地端服務。

適合用在哪裡

Web App 需要連地端 DB / API
不想開 VPN 或 Public IP
公司內網服務不能對外開放
想快速打通雲地連線（低維運成本）

流程步驟

1. 建立 Hybrid Connection（雲端端）

在 Azure Portal 建立 Hybrid Connection
設定目標：
- Host（地端服務 IP / hostname）
- Port（例如 1433 / 80 / 443）
本質是 Azure 幫你建立一條「轉送通道」，不是直接連線

2. Web App 綁定 Hybrid Connection

到 Web App → Networking → Hybrid Connections
加入剛剛建立的 Hybrid Connection
綁定後，Web App 存取該 Host:Port 時，會自動走這條通道

3. 地端安裝 Connection Manager

安裝 Hybrid Connection Manager（HCM）
登入 Azure 帳號並選擇該 Hybrid Connection
HCM 會主動「向 Azure 建立 outbound 連線」（重點）
不需要開 inbound port（防火牆壓力小）

4. 驗證連線

Web App 直接用：
- Host（設定的名稱）
- Port
不需改 DNS、不需改程式架構
成功即代表雲端 → 地端通道已建立

補充

HCM 是 主動連出去，所以不用開防火牆 inbound（常見誤解）
只支援 TCP，不支援 UDP
若連不到，先確認：
- HCM 是否 Online
- Port 是否正確
- 地端服務是否允許本機連線

指令 / 範例整理

<details> <summary>Click to expand</summary>

# 測試連線（Web App Console）
tcpping your-host 1433

# 常見 DB 連線字串（範例）
Server=your-host,1433;Database=DB;User Id=xxx;Password=xxx;

</details>

收尾

Hybrid Connection 就像一條「偷偷打洞的安全管道」，不用 VPN 也能穩穩通；先確認 HCM 在線，再談其他問題。

參考來源

https://learn.microsoft.com/azure/app-service/app-service-hybrid-connections

NuGet 套件發布與本地測試實戰：從推送到驗證一次搞懂

Fri, 25 Jul 2025 00:00:00 GMT

結論

發佈後直接用「專案參考」測試，比重新下載套件更快、更可控。

適合用在哪裡

自建 NuGet 私服 / 公司內部套件
開發共用工具（Logging / Utils / SDK）
發佈後想快速驗證功能是否正常
避免反覆 push / install 浪費時間

流程步驟

1. 推送 NuGet 套件

將打包好的 .nupkg 上傳到 NuGet Server
確認 API Key 與 Server URL 正確

# 推送套件
dotnet nuget push -s <https://xxx.yyy.zzz/v3/index.json> -k KEYXXX1234 AppLogger.1.0.0.nupkg

為什麼：
- 讓其他專案可透過 NuGet 安裝
- 作為正式版本發佈來源

2. 使用「專案參考」進行測試

不直接安裝 NuGet 套件
改用本地專案測試操作：
方案右鍵 → 加入現有專案（套件專案）
專案 → 相依性 → 新增專案參考
選擇你的套件專案
為什麼：
- 修改後立即生效（不用重包）
- Debug 更方便（可直接追進套件）

3. 驗證功能是否正常

執行主專案
確認：
- API / Method 是否正常
- DI / 設定是否正確
- 相依套件是否缺漏

// 範例：測試 Logger 套件
var logger = new AppLogger();
logger.Log("測試訊息");

補充

不要每次測試都 push 套件 → 會拖慢開發節奏
專案參考測試 OK 再重新打包發布
注意版本號，不然 NuGet 可能抓舊版本

指令 / 範例整理

<details> <summary>Click to expend</summary>

# 推送 NuGet 套件
dotnet nuget push -s <https://xxx.yyy.zzz/v3/index.json> -k KEYXXX1234 AppLogger.1.0.0.nupkg

</details>

收尾

測試階段用專案參考，發佈再用 NuGet，節奏會乾淨很多。

連不到 DB？用 Hosts 強制綁 IP 解決 DNS 問題

Fri, 25 Jul 2025 00:00:00 GMT

結論

用 Hosts 直接指定「IP → 網址」，可繞過 DNS，快速驗證或修正連線問題

適合用在哪裡

測試環境 DNS 尚未設定完成
DB / API 網址解析錯誤
VPN / Private Link 導致 DNS 指錯 IP
想強制連到指定機器（除錯用）

流程步驟

1. 修改 Hosts 檔案

到路徑 C:\\Windows\\System32\\drivers\\etc
用「系統管理員」開啟 hosts
新增一行 IP 對應網址，直接覆蓋 DNS 解析

10.10.0.1 test.database.windows.net

本機會優先使用這筆設定，不再查 DNS

2. 套用設定

儲存後不一定立即生效，需刷新 DNS 快取

ipconfig /flushdns

避免還在用舊的 DNS 結果

3. 驗證是否生效

用 ping 或 nslookup 確認解析結果

ping test.database.windows.net

若 IP 顯示為 10.10.0.1，代表設定成功

補充

Hosts 只影響「本機」，不會影響其他人
若連線異常，優先檢查是否有舊 Hosts 殘留
Azure / Private Endpoint 常會被 Hosts 覆蓋導致誤判

指令 / 範例整理

<details> <summary>Click to expand</summary>

# Hosts 設定
10.10.0.1 test.database.windows.net

# 清除 DNS
ipconfig /flushdns

# 驗證
ping test.database.windows.net

</details>

收尾

Hosts 是最快的「強制導流工具」，但記得用完要清，別害未來的你

GitHub 不接受 100MB 以上檔案？使用 Git LFS 解決大檔案 Commit 問題

Fri, 25 Jul 2025 00:00:00 GMT

結論

當 GitHub 因檔案超過 100MB 而拒絕 Push 時，可透過 Git LFS（Large File Storage）管理大型檔案，即使使用 TortoiseGit 也能正常 Commit 與 Push。

適合用在哪裡

使用 GitHub 管理大型檔案
專案包含壓縮檔、安裝包、模型檔案等大容量檔案
使用 TortoiseGit 進行版本控制
遇到 GitHub 100MB 檔案限制
需要將既有大型檔案轉換為 Git LFS 管理

流程步驟

1. 安裝 Git LFS

從 Git LFS 官網下載並安裝
安裝完成後只需初始化一次

# 初始化 Git LFS
git lfs install

GitHub 雖然支援 Git LFS，但本機必須先安裝並啟用，否則無法正常追蹤大型檔案。

2. 將既有大檔案轉換為 Git LFS

如果專案中已經存在超過 100MB 的檔案，建議直接使用 Git LFS Migration 功能。

# 將所有超過 100MB 的檔案轉換為 LFS
git lfs migrate import--everything--above=100MB

此指令會掃描整個 Repository 歷史紀錄，並將符合條件的大檔案改為 Git LFS 管理，不需指定副檔名。

適合：

舊專案
已經 Commit 過大型檔案
不確定有哪些檔案超過限制

3. 指定特定副檔名使用 Git LFS

若專案固定會放入特定格式的大檔案，也可以直接設定追蹤規則。

# 追蹤 7z 檔案
git lfs track"*.7z"

# 追蹤 tar.gz 檔案
git lfs track"*.tar.gz"

執行後會自動更新 .gitattributes，後續新增的檔案都會自動使用 Git LFS 儲存。

4. 使用 TortoiseGit Commit 與 Push

完成 Git LFS 設定後，即可回到 TortoiseGit 操作。

右鍵 → TortoiseGit → Commit
確認 .gitattributes 已加入版本控制
Commit
Push 到 GitHub 此時大型檔案實際上會存放於 Git LFS Storage，而 Git Repository 僅保留指標檔，因此不會再遇到 GitHub 的 100MB 限制。

補充

常見錯誤

錯誤訊息	原因
File exceeds GitHub's file size limit of 100 MB	檔案未使用 Git LFS 管理
Git LFS not installed	本機尚未安裝 Git LFS
Push 被拒絕	Repository 歷史紀錄中仍存在超大檔案

實務建議

新專案可直接設定常用副檔名追蹤規則
舊專案建議使用 git lfs migrate import
若已 Push 過超大檔案，需重新改寫歷史紀錄後再 Push

指令 / 範例整理

<details> <summary>Click to expand</summary>

# 安裝後初始化
git lfs install

# 將所有超過 100MB 檔案轉換為 LFS
git lfs migrate import--everything--above=100MB

# 追蹤指定副檔名
git lfs track"*.7z"
git lfs track"*.tar.gz"

# 查看目前追蹤規則
git lfs track

# 查看 LFS 管理檔案
git lfs ls-files

</details>

收尾

GitHub 的 100MB 限制並不代表大型檔案無法納入版本控制，透過 Git LFS 搭配 TortoiseGit，即可用原本的操作流程管理大型檔案。

使用 IdentityServer4 + ASP.Net Identity 初始化專案流程

Fri, 25 Jul 2025 00:00:00 GMT

結論

用 is4aspid 範本 + Migration + Seed，一次完成 IdentityServer4 + 使用者系統初始化。

適合用在哪裡

需要快速建立 OAuth / OpenID Connect Server
想整合 ASP.NET Identity（帳密登入）
建立內部驗證服務或 SSO 系統
測試或學習 IdentityServer 架構

流程步驟

1. 安裝範本並建立專案

使用 dotnet new 安裝 IdentityServer4 範本
建立整合 ASP.NET Identity 的專案（is4aspid）
為什麼：這個範本已內建登入、使用者管理，不用自己刻

# 安裝範本
dotnet new -i identityserver4.templates

# 建立專案（含 ASP.NET Identity）
dotnet new is4aspid -n IdentityServerAspNetIdentity

常用範本簡單對照：

範本	用途
is4empty	空專案
is4inmem	記憶體測試
is4ef	DB 儲存設定
is4aspid	整合帳密登入（推薦）

2. 建立資料庫（Migration）

新增 Migration（產生資料表結構）
更新資料庫（建立 Identity + IdentityServer Tables）
為什麼：IdentityServer 需要 DB 存 client / user / config

# 建立 Migration
dotnet ef migrations add InitialCreate

# 建立資料表
dotnet ef database update

3. 初始化 Seed 資料

啟動專案時加 /seed 參數
自動寫入測試使用者、Client 設定
為什麼：避免手動建資料，直接可測試登入流程

dotnet run /seed

程式碼核心：

var seed = args.Contains("/seed");

if (seed)
{
    args = args.Except(new[] { "/seed" }).ToArray();
}

var host = CreateHostBuilder(args).Build();

if (seed)
{
    // 初始化資料
    var config = host.Services.GetRequiredService<IConfiguration>();
    var connectionString = config.GetConnectionString("DefaultConnection");

    SeedData.EnsureSeedData(connectionString);
    return 0;
}

補充

IdentityServer4 已停止維護，正式專案建議評估 Duende（需付費）
Seed 只適合開發環境，正式環境請用 Migration + Script 控管
/seed 設計很方便，但要避免誤用在 Production

收尾

三步驟搞定驗證系統初始化，重點不是寫程式，是選對範本。工程上：先能跑，再優化。

Outlook 信件關鍵字觸發 Windows 通知？用 Snoretoast 一次搞定

Fri, 25 Jul 2025 00:00:00 GMT

結論

用 Outlook VBA + Snoretoast，可針對信件內容/主旨自動觸發 Windows 通知

適合用在哪裡

需要即時關注特定信件（報名 / 告警 / 任務通知）
不想一直盯 Outlook
有簡單 VBA 經驗的工程師
想做輕量級通知機制（不引入外部服務）

流程步驟

1. 設定 Outlook 監聽收件匣

綁定 Inbox Items，監聽新信件進來
使用 Items_ItemAdd 事件觸發
這是整個流程的入口，沒這段就不會自動執行

Private WithEvents Items As Outlook.Items

Private Sub Application_Startup()
    Dim Ns As Outlook.NameSpace
    Set Ns = Application.GetNamespace("MAPI")
    Set Items = Ns.GetDefaultFolder(olFolderInbox).Items
End Sub

2. 判斷信件條件 + 抓關鍵內容

檢查 Subject / Body 是否包含指定關鍵字
從信件內抓指定資訊（例如：報名時間）
避免抓到轉寄內容（直接中斷）

Private Sub Items_ItemAdd(ByVal Item As Object)
    On Error Resume Next
    If TypeOf Item Is Outlook.MailItem Then
        Dim mail As Outlook.MailItem
        Set mail = Item

        Dim signUpLine As String
        signUpLine = GetLineWithKeyword(mail.Body, "報名時間")

        If InStr(LCase(mail.Subject), "testa") > 0 And _
           InStr(LCase(mail.Body), "testb") > 0 Then

            Call ShowToast(Replace(mail.Subject, " ", ""), signUpLine)
        End If
    End If
End Sub

3. 呼叫 Snoretoast 顯示通知

使用 Shell 執行外部 exe
設定標題、內容、顯示時間、圖片
Snoretoast 是核心推播工具 (https://github.com/KDE/snoretoast)

Private Sub ShowToast(title As String, message As String)
    Dim cmd As String
    cmd = "D:\\Snoretoast\\snoretoast.exe -appID ""OutlookNotify"" -t """ & title & """ -m """ & message & """ -d long -p D:\\Snoretoast\\01.jpg "
    Shell cmd, vbHide
End Sub

4. 抽取信件關鍵行（避免抓錯內容）

將信件拆行後逐行搜尋
遇到轉寄分隔直接停止
清除空白 / Tab 避免格式干擾

Private Function GetLineWithKeyword(bodyText As String, keyword As String) As String
    Dim lines() As String
    Dim i As Long
    lines = Split(bodyText, vbCrLf)

    For i = LBound(lines) To UBound(lines)
        If InStr(lines(i), "-----Original Message-----") > 0 Or _
           InStr(lines(i), "-----轉寄郵件-----") > 0 Then
            Exit For
        End If

        If InStr(lines(i), keyword) > 0 Then
            GetLineWithKeyword = Trim(lines(i))
            GetLineWithKeyword = Replace(GetLineWithKeyword, " ", "")
            GetLineWithKeyword = Replace(GetLineWithKeyword, vbTab, "")
            Exit Function
        End If
    Next i

    GetLineWithKeyword = "(找不到報名時間)"
End Function

補充

Snoretoast 路徑需正確，否則不會跳通知
Outlook 需開啟且 VBA 有啟用
關鍵字建議轉小寫比對，避免大小寫問題

指令 / 範例整理

<details> <summary>Click to expend</summary>

snoretoast.exe -appID "OutlookNotify" -t "Title" -m "Message" -d long -p image.jpg

</details>

收尾

這做法很土，但穩、可控，適合內部自動通知場景
建議把關鍵字抽成設定檔，會更好維護

PowerShell 美化教學：oh-my-posh 主題設定快速上手

Fri, 25 Jul 2025 00:00:00 GMT

結論

用 oh-my-posh + 主題設定，一行指令直接讓 PowerShell 變好看又好用

適合用在哪裡

想提升 CLI 使用體驗的工程師
長時間使用 PowerShell / Terminal 的人
想快速辨識 Git / 路徑 / 狀態資訊

流程步驟

1. 安裝 oh-my-posh

安裝工具（略過已安裝）
確認指令可用

oh-my-posh --version

2. 查詢主題

查看內建主題清單

Get-PoshThemes

用來挑喜歡的樣式（建議先用預設測試）

3. 套用主題

初始化 PowerShell + 指定主題

oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\\jandedobbeleer.omp.json" | Invoke-Expression

會立即套用樣式（當前 session）

4. 設定永久生效

開啟 Profile

notepad $PROFILE

加入以下內容

oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\\jandedobbeleer.omp.json" | Invoke-Expression

補充

字體需 Nerd Font（否則圖示會亂碼）
Profile 找不到 → 先執行 $PROFILE 建立
主題可自由換（json 檔直接改）

指令 / 範例整理

<details> <summary>Click to expend</summary>

# 查詢主題
Get-PoshThemes

# 套用主題
oh-my-posh init pwsh --config "$env:POSH_THEMES_PATH\\jandedobbeleer.omp.json" | Invoke-Expression

# 編輯 Profile
notepad $PROFILE

</details>

收尾

一行指令，讓你的 CLI 從工地風變成精品店，順眼真的會讓人多寫幾行 code

EF Core 查詢忽快忽慢？用 RECOMPILE 解掉 Parameter Sniffing

Fri, 25 Jul 2025 00:00:00 GMT

結論

用 DbCommandInterceptor + TagWith，即可在 EF Core 查詢加上 OPTION(RECOMPILE)，快速避開 Parameter Sniffing。

適合用在哪裡

查詢「同一支 SQL，但速度不穩」的場景
EF Core 查詢 timeout，但 SSMS 正常
條件差異大（例如：熱門 vs 冷門資料）
不想改 SQL，但需要快速解法

流程步驟

1. 註冊 Interceptor

在 DbContext 注入自訂 Interceptor
讓 EF Core 有機會攔截 SQL 並改寫

builder.UseSqlServer(connectionString)
    .UseRecompileExtensions(); // 註冊攔截器

2. 在查詢標記 RECOMPILE

用 TagWith 做標記（EF Core 內建）
讓 Interceptor 知道哪段 SQL 要處理

var name = "SomeName";
var result = context.SomeItems
    .Where(x => x.Name == name)
    .WithRecompile() // 加上標記
    .ToList();

實際 SQL：

SELECT [s].[Id], [s].[Name]
FROM [SomeItems] AS [s]
WHERE [s].[Name] = @__name_0
OPTION(RECOMPILE)

3. 實作 Interceptor 改寫 SQL

偵測 Tag
移除 comment 並補上 OPTION(RECOMPILE)

public static class RecompileExtensions
{
    private const string RecompileTag = "recompile_query_tag";
    private const string RecompileComment = "-- " + RecompileTag + "\\r\\n";

    public static DbContextOptionsBuilder UseRecompileExtensions(this DbContextOptionsBuilder builder)
    {
        return builder.AddInterceptors(RecompileInterceptor.Instance);
    }

    public static IQueryable<T> WithRecompile<T>(this IQueryable<T> query)
    {
        return query.TagWith(RecompileTag);
    }

    private class RecompileInterceptor : DbCommandInterceptor
    {
        public static RecompileInterceptor Instance = new();

        public override InterceptionResult<DbDataReader> ReaderExecuting(
            DbCommand command,
            CommandEventData eventData,
            InterceptionResult<DbDataReader> result)
        {
            CorrectCommand(command);
            return base.ReaderExecuting(command, eventData, result);
        }

        private static void CorrectCommand(DbCommand command)
        {
            var newQuery = command.CommandText.Replace(RecompileComment, "");

            if (!ReferenceEquals(newQuery, command.CommandText))
            {
                if (newQuery.StartsWith("\\r\\n"))
                    newQuery = newQuery.Substring(2);

                newQuery += "\\r\\nOPTION(RECOMPILE)";
                command.CommandText = newQuery;
            }
        }
    }
}

補充

RECOMPILE 每次都重新產生執行計畫，CPU 成本會增加，不適合高頻查詢
適合「查詢不穩」而不是「查詢本身慢」
若是全域問題，可考慮 DB 層級關閉 Parameter Sniffing

ALTER DATABASE SCOPED CONFIGURATION SET PARAMETER_SNIFFING = OFF;

指令 / 範例整理

<details> <summary>Click to expand</summary>

// 註冊
builder.UseRecompileExtensions();

// 使用
query.WithRecompile().ToList();

-- DB 層級關閉 Parameter Sniffing
ALTER DATABASE SCOPED CONFIGURATION
SET PARAMETER_SNIFFING = OFF;

</details>

收尾

當 EF 跟 SQL 表現不一致時，這招通常能快速止血；但長期還是要回頭優化索引與查詢。

參考來源

https://stackoverflow.com/questions/73073436/ef-core-takes-a-lot-of-time-sometimes-to-perform-select-query

ASP.NET Core + OpenIddict 實作筆記：Password Flow 與 Refresh Token

Fri, 25 Jul 2025 00:00:00 GMT

結論

這篇整理的是 OpenIddict 在 ASP.NET Core 專案中的最小可用建置流程，包含套件安裝、資料表建立、/connect/token 實作、Refresh Token 流程，以及 Azure 上常見的憑證權限坑。

適合用在哪裡

要自己做登入授權中心的 .NET 專案
需要發 access token / refresh token 的 API 系統
已有 ASP.NET Core Identity，想接 OpenIddict
部署到 Azure App Service，遇到憑證或權限問題的人

流程步驟

1. 先把資料層建起來

先安裝需要的套件，最少會用到 Microsoft.EntityFrameworkCore.SqlServer、Microsoft.EntityFrameworkCore.Tools、OpenIddict.AspNetCore、OpenIddict.EntityFrameworkCore。接著用 Migration 產生 Schema，這一步的重點不是花俏，而是先讓 OpenIddict 需要的資料表真的落地，不然後面 Token 流程再漂亮也只是空中樓閣。實作上可直接跑 EF Migration，若想先看 SQL，也能先輸出 script 再交給 DBA 檢查。

# Visual Studio Package Manager Console
Add-Migration InitialCreate
Update-Database

# DotNet CLI
dotnet ef migrations add InitialCreate
dotnet ef database update

# 產生 SQL 腳本
dotnet ef migrations script InitialCreate --context DefaultDbContext

2. 在 Startup 註冊 OpenIddict 與 Identity

這一步要做的是把 DbContext、Identity、OpenIddict Core / Server / Validation 串起來。重點有三個：一是 options.UseOpenIddict() 要掛進 DbContext；二是 Server 端要開 /connect/token 並允許 PasswordFlow、RefreshTokenFlow；三是 Token 的壽命、Scope、簽章憑證要先定清楚。若你只是先在開發機測通流程，可以先用 AddDevelopmentEncryptionCertificate() 與 AddDevelopmentSigningCertificate()，但正式環境別偷懶，這種東西混過去，日後都會回來找你 (´-ω-`)。

services.AddDbContext<DefaultDbContext>(options =>
{
    options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"));
    options.UseOpenIddict(); // 讓 OpenIddict 使用 EF Core
});

services.AddOpenIddict()
    .AddCore(options =>
    {
        options.UseEntityFrameworkCore()
            .UseDbContext<DefaultDbContext>();
    })
    .AddServer(options =>
    {
        options.SetTokenEndpointUris("/connect/token");
        options.SetUserinfoEndpointUris("/connect/userinfo");

        options.AllowPasswordFlow();
        options.AllowRefreshTokenFlow();
        options.AllowCustomFlow("custom_flow_name");

        options.UseReferenceAccessTokens();
        options.UseReferenceRefreshTokens();

        options.RegisterScopes(
            OpenIddictConstants.Permissions.Scopes.Email,
            OpenIddictConstants.Permissions.Scopes.Profile,
            OpenIddictConstants.Permissions.Scopes.Roles);

        options.SetAccessTokenLifetime(TimeSpan.FromMinutes(30));
        options.SetRefreshTokenLifetime(TimeSpan.FromDays(7));

        options.AddDevelopmentEncryptionCertificate()
               .AddDevelopmentSigningCertificate();

        options.UseAspNetCore()
               .EnableTokenEndpointPassthrough();
    })
    .AddValidation(options =>
    {
        options.UseLocalServer();
        options.UseAspNetCore();
    });

3. 建立測試 Client 與使用者，先把登入鏈路打通

在開發環境先自動建立一組 Client 與管理者帳號，能大幅減少初始化時的手工操作。這段的目的很單純：確認你的資料表、Identity、OpenIddict 三者真的接起來，而不是每次測試都在懷疑到底是帳號錯、Client 沒建、還是授權配置有洞。這裡會建立 default-client，並產出一個 admin 使用者，密碼先用 PasswordHasher 轉成雜湊後存入。

#if DEBUG
CreateCientAndUser(app);
#endif

private static void CreateCientAndUser(IApplicationBuilder app)
{
    using var scope = app.ApplicationServices
        .GetRequiredService<IServiceScopeFactory>()
        .CreateScope();

    var context = scope.ServiceProvider.GetRequiredService<DefaultDbContext>();
    context.Database.EnsureCreated();

    var manager = scope.ServiceProvider.GetRequiredService<IOpenIddictApplicationManager>();
    var existingClientApp = manager.FindByClientIdAsync("default-client").GetAwaiter().GetResult();

    if (existingClientApp == null)
    {
        manager.CreateAsync(new OpenIddictApplicationDescriptor
        {
            ClientId = "default-client",
            ClientSecret = "your-client-secret",
            DisplayName = "Default client application",
            Permissions =
            {
                OpenIddictConstants.Permissions.Endpoints.Token,
                OpenIddictConstants.Permissions.GrantTypes.Password,
                OpenIddictConstants.Permissions.GrantTypes.RefreshToken
            }
        }).GetAwaiter().GetResult();
    }
}

4. 實作 `/connect/token`，把 Password 與 Refresh Token 都接上

/connect/token 是整個流程的核心入口，收到請求後先判斷 Grant Type，再分流到不同處理方法。Password Grant 的做法是：找到使用者、驗證密碼、建立 ClaimsIdentity、加上角色與必要 Scope，最後回傳 SignIn(...) 讓 OpenIddict 幫你發 Token。Refresh Token 則簡單很多，直接從目前驗證內容取出 ClaimsPrincipal 再重新簽發即可。白話講，前者是「靠帳密換票」，後者是「拿舊票換新票」。

[HttpPost("~/connect/token")]
[AllowAnonymous]
public async Task<IActionResult> Exchange()
{
    var oidcRequest = HttpContext.GetOpenIddictServerRequest();

    if (oidcRequest.IsPasswordGrantType())
        return await TokensForPasswordGrantType(oidcRequest);

    if (oidcRequest.IsRefreshTokenGrantType())
        return await TokenForRefreshGrantType();

    return BadRequest(new OpenIddictResponse
    {
        Error = OpenIddictConstants.Errors.UnsupportedGrantType
    });
}

private async Task<IActionResult> TokensForPasswordGrantType(OpenIddictRequest request)
{
    var user = await _userManager.FindByNameAsync(request.Username);
    if (user == null)
        return Unauthorized();

    var signInResult = await _signInManager.CheckPasswordSignInAsync(user, request.Password, false);
    if (!signInResult.Succeeded)
        return Unauthorized();

    var identity = new ClaimsIdentity(
        TokenValidationParameters.DefaultAuthenticationType,
        OpenIddictConstants.Claims.Name,
        OpenIddictConstants.Claims.Role);

    identity.AddClaim(OpenIddictConstants.Claims.Subject, user.Id.ToString(), OpenIddictConstants.Destinations.AccessToken);
    identity.AddClaim(OpenIddictConstants.Claims.Username, user.Username, OpenIddictConstants.Destinations.AccessToken);

    foreach (var userRole in user.UserRoles)
    {
        identity.AddClaim(OpenIddictConstants.Claims.Role, userRole.Role.NormalizedName, OpenIddictConstants.Destinations.AccessToken);
    }

    var principal = new ClaimsPrincipal(identity);
    principal.SetScopes(new[]
    {
        OpenIddictConstants.Scopes.Roles,
        OpenIddictConstants.Scopes.OfflineAccess,
        OpenIddictConstants.Scopes.Email,
        OpenIddictConstants.Scopes.Profile
    });

    return SignIn(principal, OpenIddictServerAspNetCoreDefaults.AuthenticationScheme);
}

private async Task<IActionResult> TokenForRefreshGrantType()
{
    var principal = (await HttpContext.AuthenticateAsync(
        OpenIddictServerAspNetCoreDefaults.AuthenticationScheme)).Principal;

    return SignIn(principal, OpenIddictServerAspNetCoreDefaults.AuthenticationScheme);
}

補充

Azure App Service 若遇到 WindowsCryptographicException: Access is denied.，可先補上 WEBSITE_LOAD_USER_PROFILE=1，這通常是在載入開發憑證時踩到的坑。
UseReferenceAccessTokens() / UseReferenceRefreshTokens() 代表實際 Token 內容存在資料庫，外部拿到的是參照值，方便控管，但也更依賴資料庫穩定性。
Password Flow 雖然實作快，但通常只適合受控系統或內部整合；若是對外產品，授權流程要再多想一步，別只求先能跑。

指令 / 範例整理

<details> <summary>Click to expand</summary>

# 安裝後執行 Migration
Add-Migration InitialCreate
Update-Database

dotnet ef migrations add InitialCreate
dotnet ef database update
dotnet ef migrations script InitialCreate --context DefaultDbContext

POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=password
client_id=default-client
client_secret=your-client-secret
username=admin
password=your-password
scope=offline_access profile email roles

POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token
client_id=default-client
client_secret=your-client-secret
refresh_token=your-refresh-token

</details>

收尾

OpenIddict 真的不難，難的是一開始把資料表、授權設定、Token 流程一次接對；先求最小可用，再慢慢補安全與正式環境配置，這才是正常活路。

參考來源

OpenIddict官方文件 https://github.com/openiddict/openiddict-core
在 .NET 5 中使用 OpenIddict 設置令牌身份驗證 https://nwb.one/blog/openid-connect-dotnet-5
使用 OpenIddict 建立一個支援 Client Credentials Grant 的 Authentication Server 來保護你的 Web API https://wezmag.github.io/posts/protect-api-with-client-credentials-grant-using-openiddict-part-1/
使用 OpenIddict 設置授權服務器 - 第 VI 部分 - 刷新令牌 https://dev.to/robinvanderknaap/setting-up-an-authorization-server-with-openiddict-part-vi-refresh-tokens-5669
OpenIddict詳細流程 https://www.cnblogs.com/liyouming/p/15772403.html

Robocopy 教學：強大又穩定的備份神器

Fri, 25 Jul 2025 00:00:00 GMT

結論

用一條 Robocopy 指令即可完成「鏡像備份＋排除＋Log＋加速」，適合日常自動化備份。

適合用在哪裡

定期備份（每日 / CI 前備份）
大量檔案同步（專案資料夾）
需要排除 node_modules / bin 等暫存資料
需要保留權限與時間戳的情境

流程步驟

1. 建立基礎備份指令

使用 robocopy 指定來源與目的地，並加上 mirror 模式同步整體資料
/mir 會讓目的地完全等同來源（包含刪除），適合「真正備份」而非單純 copy
指令如下：

robocopy "來源資料夾" "目的地資料夾" /mir

2. 加入排除與效能優化

排除不需要的檔案（如 .bak、.scc）與資料夾（bin、obj、node_modules）
/MT:100 開啟多執行緒加速，大量檔案時差很多
/xj 避免 Junction 無限遞迴（常見在 node_modules）

robocopy "來源資料夾" "目的地資料夾" /mir /xj /MT:100 /xf *.scc *.bak ^
  /xd "packages" "bin" "obj" "node_modules" ".vs" "TempFile" "Data" "history"

3. 控制同步範圍＋輸出 Log

/maxage:7 限制只同步最近 7 天變更，減少不必要 I/O
將結果輸出到 log，方便排錯或稽核

robocopy "來源資料夾" "目的地資料夾" /mir /xj /MT:100 /xf *.scc *.bak ^
  /xd "packages" "bin" "obj" "node_modules" ".vs" "TempFile" "Data" "history" ^
  /maxage:7 > .\\Log\\%dd%.log

補充

/mir 會刪除目的地多餘檔案，誤用會直接「幫你清空」
/MT 雖然快，但過高可能吃滿 CPU 或 IO，建議 16～64 起測
%DATE% 格式會受系統語系影響，跨機器可能要調整

指令 / 範例整理

<details> <summary>Click to expend</summary>

:: 建立 Log 資料夾
if not exist ".\\Log" mkdir ".\\Log"

:: 產生日期（YYYYMMDD）
set dd=%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%

:: 完整備份指令
robocopy "來源資料夾" "目的地資料夾" /mir /xj /MT:100 /xf *.scc *.bak ^
  /xd "packages" "bin" "obj" "node_modules" ".vs" "TempFile" "Data" "history" ^
  /maxage:7 > .\\Log\\%dd%.log

</details>

收尾

Robocopy 不難，難的是「參數組合」，這套基本夠打 90% 備份場景。
建議先在測試資料夾跑一次，確認 /mir 行為再上正式環境。