🔎解決 SQL Server Named Pipe 連線失敗與 Spotfire 建表錯誤的完整指南

-

 

前言

在安裝 TIBCO Spotfire 伺服器並執行資料庫初始化批次檔（create_actionlog_db.bat）時，有時會遇到 SQL Server 連線錯誤，例如： 

no named pipe instance matching '' returned from host 'SPFSDB01'
Timed out waiting for pipe '\\.\pipe\SQLLocal\SQLEXPRESS' to come available

對不熟悉資料庫連線的人來說，這可能完全摸不著頭緒。其實，這是 SQL Server 連線通訊協定設定 與 批次檔連線參數 的組合問題。本文將用軟體工程師的角度，完整解釋原因並提供可行解法。



問題背景

Spotfire 安裝腳本會呼叫 sqlcmd 來建立 Action Log 資料表。然而：

  1. 找不到 sqlcmd：

    • 系統未安裝 Microsoft SQL Server Command Line Utilities

    • 或安裝後沒有設定 PATH

  2. Named Pipes 連線失敗：

    • SQL Server 沒開啟 Named Pipes 協定

    • 批次檔沒有帶正確的伺服器與實例名稱

    • SQL Server Browser 沒啟動

  3. TCP/IP 未啟用：

    • 批次檔默認使用 Named Pipes，若沒啟動就會失敗

    • 沒設定固定 TCP 埠，導致命名實例連線解析失敗



常見錯誤訊息解析

1. no named pipe instance matching '' returned from host

  • 原因：-S 參數傳入空值，批次檔沒接到伺服器名稱

  • 解法：執行批次檔時帶上完整伺服器與實例，例如： 

    create_actionlog_db.bat SPFSDB01\SQLEXPRESS sa MyPassword

2. Timed out waiting for pipe

  • 原因：Named Pipes 協定關閉或 SQL Server 服務未啟動

  • 解法：啟動 SQL Server 服務，並在 Configuration Manager 中啟用 Named Pipes 或改用 TCP



解決步驟

步驟 1：安裝與確認 sqlcmd 

where sqlcmd

若找不到，使用 Winget 安裝：

winget install Microsoft.sqlcmd

步驟 2：啟動 SQL Server 服務

  1. 打開 services.msc

  2. 找到 SQL Server (SQLEXPRESS) → 設為 Running

  3. 若用命名實例，啟動 SQL Server Browser

步驟 3：啟用 TCP/IP 並設定固定埠

  1. 開啟 SQL Server Configuration Manager

  2. 到 SQL Server Network Configuration → Protocols for SQLEXPRESS

  3. 啟用 TCP/IP

  4. 在 IPAll 中設定 TCP Port = 1433，清空 Dynamic Ports

  5. 重啟 SQL Server 服務

步驟 4：測試 TCP 連線 

sqlcmd -S tcp:localhost,1433 -E -Q "SELECT @@VERSION;"

或使用 SQL 登入：

sqlcmd -S tcp:SPFSDB01,1433 -U sa -P MyPassword -Q "SELECT @@VERSION;"

步驟 5：修改批次檔參數或內容

若批次檔支援參數，直接傳入 TCP 格式：

create_actionlog_db.bat tcp:SPFSDB01,1433 sa MyPassword

若不支援，打開 .bat 檔，將 -S %SERVER% 改為： 

-S tcp:%SERVER%,1433


附加建議

  • 固定埠 vs SQL Browser：
    固定埠方便直連；若使用動態埠，需啟用 SQL Browser。

  • 權限：
    建立資料庫需要 sysadmin 或 dbcreator 權限。

  • 日誌檔排錯：
    批次檔失敗時，檢查 actionlog.txt 會顯示完整 SQL 錯誤。



結論

這類 Spotfire + SQL Server 的安裝錯誤，核心原因大多是 連線協定與參數不正確。
只要依序確保：

  1. sqlcmd 工具可用

  2. SQL Server 服務啟動

  3. TCP/IP 啟用且固定埠

  4. 批次檔帶正確的伺服器與實例

基本上就能解決 Named Pipes 連線錯誤，順利建立 Spotfire 所需的資料表。

留言

張貼留言

這個網誌中的熱門文章

🔍Vue.js 專案錯誤排查：解決 numericFields is not defined 與合併儲存格邏輯最佳化

-
  前言 在前端開發專案中，處理表格數據與 Excel 匯出是常見的需求。 最近在專案中，遇到一個常見但讓人頭痛的錯誤訊息： Uncaught ReferenceError: numericFields is not defined 本文將用簡單的方式，帶你了解這個錯誤的成因、如何修改程式碼，以及如何最佳化「合併儲存格」與「數值加總」的邏輯。 問題場景：表格合併與數值加總 專案中需要達成以下功能： 同一個 APS_PLAN_NO 下，若 TFT4 相同，則 TFT5 欄位要合併。 數值欄位要加總，並以千分位格式輸出。 匯出到 Excel 時，也要套用相同邏輯。 在 Vue 的 rowSpans 計算邏輯中，初始版本如下： const rowSpans = computed ( () => { const rows = filteredData. value const spans = rows. map ( () => { const obj = {} tableHeaders. value . forEach ( key => obj[key] = 0 ) return obj }) ... return spans }) 但是，當我們在 exportToExcel() 使用時，出現了以下錯誤： Uncaught ReferenceError: numericFields is not defined 錯誤原因 這個錯誤訊息代表： 👉 numericFields 在程式中根本沒有宣告，所以瀏覽器不知道它是什麼。 舉例來說，假設我們在程式裡寫了這樣的判斷： if (numericFields. includes (key)) { // 處理數值欄位 } 但其實 numericFields 沒有定義，程式就會直接報錯。 解決方案：定義 numericFields ...
閱讀完整內容

🛠【ASP.NET Core + Oracle】解決 ORA-00904 "FALSE": 無效的 ID 錯誤與資料欄位動態插入顯示問題

-
  🔍 問題描述 在開發群創光電內部的 APS 排程系統（使用 ASP.NET Core + Vue 3 + Oracle），前端發生多筆錯誤訊息： Request failed with status code 500 Oracle.ManagedDataAccess.Client.OracleException: ORA-00904: "FALSE": 無效的 ID 這是 Oracle 資料庫對布林值處理不一致造成的錯誤，我們後端嘗試將某個欄位 .Where(x => x.FLAG == false) 寫法，經由 EF Core 轉成 SQL： SELECT * FROM TABLE WHERE FLAG = FALSE 而 Oracle 並不支援 FALSE 關鍵字作為布林值 → 導致查詢失敗。 🔧 解決方案 1：避免布林值直接進入 LINQ to SQL EF Core + Oracle 不支援下列語法： .Where(x => x.IsActive == false) // ❌ Oracle 無法解析 FALSE ✅ 解法 ：將布林判斷移至 .ToList() 之後，變成記憶體篩選： var list = await db.Table.Where(x => x.Version == ver).ToListAsync(); var filtered = list.Where(x => !x.IsActive).ToList(); // ✅ 在記憶體中比對布林 🔧 解決方案 2：安全轉換 SEQ_NO 為 Decimal 後端為了將前段表 APSZFRONT 的 SEQ_NO 與 APSZLCM 的 APS_PLAN_SEQ 對應，用到了這段程式碼： Convert.ToDecimal(front.SEQ_NO) 但一旦 SEQ_NO 含有英文字母（例如 GN140CHCAAE90S_20250811_1_531 ），就會丟出 FormatException → 造成 HTTP 500。 ✅ 正確寫法（TryParse 避免失敗） ： de...
閱讀完整內容

🔎EF Core 連 Oracle 出現 ORA-00600 [kpp_concatq:2] 的完整排錯指南（含 EF Core ToString/CultureInfo 錯誤）

-
  摘要（Meta Description） 在 .NET EF Core 對 Oracle 查詢時，若遭遇 ORA-00600 [kpp_concatq:2] ，多半是查詢優化器在字串型別轉換或重寫（Query Transformation）時踩到版本 Bug。本文以實戰日誌形式，示範如何用 FromSqlRaw + 參數型別/長度對齊 + CAST + Hint 立即止血，並處理 EF Core 另一個常見錯誤：「 CultureInfo 常值被傳進 ToString 造成可能記憶體外洩 」。附可直接套用的程式碼。 目錄 錯誤現象 根因分析 三步驟「立即止血」 安全重構：可直接貼用的程式碼 進階避雷：CTE/MATERIALIZE 與 View 包裝 EF Core ToString / CultureInfo 錯誤的正確處理 版本與長期解法（根治） 效能與穩定性小技巧 檢查清單（Checklist） FAQ 結語 錯誤現象 常見堆疊片段如下（節錄）： Oracle .ManagedDataAccess .Client .OracleException ( 0 x80004005): ORA-00600 : 內部錯誤代碼, 引數: [kpp_concatq:2] , [4] , [3] ...
閱讀完整內容