DataFocus · 博客
OT Flash 接入 MySQL、Oracle、SQL Server:只讀賬號
OT Flash r57 手冊列出 26 種外部資料來源型別,從 MySQL、Oracle 到 Hive、Iceberg。安全接入的路徑是專用只讀賬號、測試通過的連線,再定時匯入到 OT Flash 自己的儲存。本文逐步講解,並點明手冊留給你自己決定的部分。
OT Flash 可以連線 26 種外部資料庫型別,包括 PostgreSQL、MySQL 和 MariaDB、Oracle、IBM DB2、SQL Server、ClickHouse、Hive、Iceberg、TiDB、OceanBase 和 SAP HANA,而且對所有型別的讀取方式都一樣:先建立一個 JDBC 式連線,再按計劃把選中的表複製到 OT Flash 自己的儲存裡。安全接入的做法是:給 OT Flash 一個除了對待分析的表執行 SELECT 之外什麼都做不了的賬號;在“新建資料來源”(New Data Source)對話方塊裡先測試連線、再儲存;然後通過一個可以設定排程的三步向導匯入表。只讀賬號這一條,r57 使用者手冊本身就有建議。本文逐步講解每個環節,以 MySQL 為例給出賬號的寫法,並點明手冊沒有寫清的地方,讓你在第一次匯入執行之前就把它們定下來。
列表上有哪些資料庫,以及列表沒有說的事
OT Flash 使用者手冊(r57,2026 年 10 月)的資料來源章節在“Supported types include”下列出:PostgreSQL、MySQL(含 MariaDB)、Oracle、IBM DB2、GaussDB 100、SQL Server、Sybase、Greenplum、ClickHouse、Kudu、ElasticSearch、TeraData、MongoDB、Prometheus、Hive、Delta Lake、Iceberg、TiDB、SelectDB / Doris、OceanBase、SAP HANA、ClickZetta、Impala、DM8(達夢)、ArgoDB 和 KingBase。一共 26 項,從常見的商業引擎到湖倉表格式,再到混合環境裡逐年積累下來的國產資料庫。
這份列表要按它的本意來讀。它列的是型別,不是版本、驅動或配置限制,手冊也沒有為任何一項標註最低版本。如果你的 Oracle 或 SQL Server 已經落後好幾個大版本,回答這個問題的是一次試連,不是這份列表。
同一個介面上還有兩處容易看錯。“DataFocus system Doris”是內建儲存,不是可供連線的外部源。資料來源分為資料庫、API 源和 HTTP 源三組,本地 CSV、Excel 和 JSON 檔案走另一條路徑;本文只討論資料庫這條路徑。
連線表單,逐欄位說明
開啟“外部資料來源”(External Data Source)頁籤,點選“新建資料來源”(New Data Source)。對話方塊按手冊原有的欄位名要求填寫以下內容:
| 欄位 | 填什麼 | 說明 |
|---|---|---|
| Data Source Type(資料來源型別) | 26 種類型之一 | 決定使用哪個驅動 |
| Source Name(資料來源名稱) | 一個你以後能認出來的名稱 | 會出現在資料表列表和匯入嚮導裡;按系統命名,不要按主機命名 |
| Server、Port(伺服器、埠) | 資料庫的主機和埠 | 從 OT Flash 主機能否連通,是你自己要保證的 |
| Database(資料庫) | 要讀取的資料庫 | 一個數據源對應一個數據庫 |
| Schema | 可選 | “If Schema is left empty, the default is used”(留空則使用預設 schema) |
| JDBC Param(JDBC 引數) | 可選,“if needed”(按需填寫) | 手冊沒有按驅動列出可接受的引數 |
| Username、Password(使用者名稱、密碼) | OT Flash 將使用的賬號 | 只讀賬號填在這裡 |
手冊的措辭很明確:“Click Connect to test the connection. When it succeeds, click Submit.”(點選 Connect 測試連線,成功後點擊 Submit。)把 Connect 當成一道門,而不是一個可有可無的步驟。JDBC Param 裡填的任何內容都應來自你所用資料庫廠商的 JDBC 文件,而且只有在帶著它通過 Connect 之後才算可信。
填表之前還有一項檢查。OT Flash 是自建部署,執行在你自己的伺服器上,所以第一種失敗往往出在路由而不是憑據:OT Flash 主機必須能在指定埠上訪問到資料庫主機。手冊沒有網路檢查清單,因為這部分沒有任何產品特有的內容。只開一條防火牆規則,從 OT Flash 主機網段到資料庫埠,別的都不開。
賬號為什麼必須只讀,它能防什麼、不能防什麼
手冊的建議寫在對話方塊下方的一條備註裡:為 OT Flash 建立“a dedicated read-only database account for OT Flash, with access only to the databases and tables you want to analyze”(一個專用的只讀資料庫賬號,只能訪問你要分析的資料庫和表)。這句話做了兩件事,值得拆開來看。
第一是範圍。這個賬號能看到什麼,就決定了日後一個許可權足夠高的 OT Flash 使用者能匯入什麼。如果用共享的應用登入賬號去連,這個範圍就變成了應用能讀到的一切,甚至可能包括它能寫的部分。專用賬號讓資料庫自己來守這條邊界,不依賴 OT Flash 內部的任何設定,也讓你的 DBA 只需審計、輪換或停用一個主體。
第二是方向。只有 SELECT,意味著一次配置失誤、一次粗心的匯入,或者一臺被攻破的 OT Flash 主機,都改不了源庫。匯入路徑是把資料往外複製;手冊裡沒有任何回寫的描述,而只讀授權讓這一點在資料庫層面成立,無論應用層怎麼做。
在 MySQL 上,標準做法是建一個使用者,再授予庫級 SELECT,依據是 MySQL 8.4 參考手冊的 GRANT 一節。賬號名、主機範圍、資料庫和密碼都是佔位符;下面是示意程式碼,未實際執行,也沒有對著 OT Flash 執行過:
-- 示意程式碼,未實際執行,未對 OT Flash 執行
CREATE USER 'otflash_ro'@'10.0.0.%' IDENTIFIED BY '<strong password>';
GRANT SELECT ON sales_db.* TO 'otflash_ro'@'10.0.0.%';
SHOW GRANTS FOR 'otflash_ro'@'10.0.0.%';
MySQL 手冊把 ON db_name.* 描述為庫級許可權,把 SHOW GRANTS 描述為核對賬號持有哪些許可權的方法。如果只需要幾張表,就在表級授予(ON sales_db.orders),而不是整個 schema。Oracle、SQL Server、PostgreSQL 和其他引擎各有自己的語法,目標完全一樣:只給 SELECT,只給要分析的物件,只允許從 OT Flash 主機網段訪問。
多數團隊容易混淆的兩條邊界:
- 憑據是機密。 它們只進對話方塊和你的金鑰庫,不進工單、聊天和運維手冊。
- 只讀賬號限制的是 OT Flash 能讀什麼,不限制 OT Flash 內部誰能看到匯入後的副本。 後者由 OT Flash 的角色和資源許可權決定,下文會講。手冊沒有說源端的限制會延續到副本上;按不會延續來對待。
是匯入,不是即時查詢:資料究竟去了哪裡
資料來源連線好之後,手冊只記載了一條路徑:Import Table > Import table from external data source(匯入資料表 > 從外部資料來源匯入資料表),一個三步向導。
- 選擇資料來源。 從下拉式清單裡選;如果還沒有,點選“Go to create new Data Source”(前往新建資料來源)。
- 選擇表。 勾選要匯入的表。
- 配置載入表(Config load tables)。 設定匯入型別,以及是否按計劃匯入。
嚮導完成後,這些表出現在資料表列表中,所有定時匯入都會以任務的形式出現在 Table Task(表任務)頁籤。
副本放在哪裡?OT Flash 在 GitHub 上的 README 寫明,Doris 把匯入的業務資料存放在內部表中;使用者手冊則把“DataFocus system Doris”列為內建資料來源。r56 的 Agent 與 MCP 手冊從另一側印證了這一點:通過 MCP 發起的表查詢以 Doris SQL 執行,原有的 Trino、Hive 和 Hadoop 服務不在 Flash 的 Agent 入口之列。OT Flash 不會在查詢時把問題轉發到你的 Oracle 或 SQL Server,它用 Doris 裡的副本作答。手冊沒有記載任何即時查詢模式,本文也不作此宣告。
這一個事實決定了兩件事,要在點選 Connect 之前定下來:
- 新鮮度由你的匯入計劃決定,而不是由源庫決定。一張每晚重新整理的表,回答的是昨天的問題。DataFocus 的版本說明也提醒規劃者:要想清楚資料如何進入 Doris,以及重新整理頻率是多少。
- 副本的治理歸 OT Flash,不歸源庫。誰在 OT Flash 裡被授予了某張匯入表,誰就能看到它,不論源資料庫原本會不會允許這個人看。
一個完整的例子:一個源、三張表、一個計劃
設想一個假設場景:一家中型分銷商,訂單管理資料庫是 MySQL 的 sales_db,裡面有 orders、order_lines 和 customers,還有另外四十張表,其中一些存著薪資和銀行賬戶資訊。分析團隊想把這三張銷售表放進 OT Flash,每晚重新整理。流程如下(示意流程,其中沒有任何一步實際執行過):
- DBA 建立賬號。
otflash_ro,限定只能從 OT Flash 主機網段訪問,GRANT SELECT的物件精確到sales_db.orders、sales_db.order_lines和sales_db.customers。不要給sales_db.*:薪資表在資料庫層面就保持不可見,SHOW GRANTS的輸出留作記錄。 - 網路只開一條規則。 從 OT Flash 主機網段到 MySQL 主機和埠。不開任何從 MySQL 主機回來的方向。
- 管理員連線資料來源。 型別選 MySQL,Source Name 填
OMS sales (MySQL),填 Server 和 Port,Database 填sales_db,Schema 和 JDBC Param 第一次嘗試時留空,再填入只讀憑據。Connect 成功,Submit。 - 管理員匯入。 Import Table > Import table from external data source;選中 OMS 資料來源;勾選三張表;在第 3 步設定匯入型別,並把每晚的計劃安排在 OMS 批處理結束之後,而不是進行當中。
- 第二天早上核對。 Table Task 應顯示三條任務,帶 Data Source、Import Type、Scheduled import time、Status 和 Last Import Time。資產目錄(Asset Catalog)應在新資料來源下顯示三張表,以及其中有關係和孤立的數量。
- 有意識地授權。 為銷售分析師建立一個自定義角色,只給這三張表的許可權;匯入許可權留給 SOURCE_MANAGER。
第 1 步是日後能救你的那一步。不管後面有什麼被關聯到 customers 上,影響範圍始終是三張表,因為這個賬號從頭到尾只能看到這三張。
定時匯入與 Table Task 頁籤
定時匯入集中在一個地方管理:資料表管理(Tables)下的 Table Task 頁籤,它列出每條任務的 Data Source、Import Type、Scheduled import time、Status 和 Last Import Time。手冊沒有列舉匯入型別,所以請讀你自己例項上的下拉式清單,不要先假設“全量”或“增量”在那裡是什麼意思。
一套經得起時間考驗的例行做法:
- 第一次定時執行之後,開啟 Table Task,對照你設定的計劃核對 Status 和 Last Import Time。
- 把計劃安排在源庫自己的載入視窗之外,匯入就永遠不會讀到一張夜間批處理只跑了一半的表。
- 一張表退役時,既從 OT Flash 裡移除,也從只讀賬號的授權裡移除。沒人用的授權仍然是授權。
手冊沒有描述重試行為、匯入失敗的告警,也沒有說明增量匯入的語義。在依賴它們之前先在你的例項上逐項測試,並決定當 Status 不是預期值時由誰來看 Table Task。
誰能看到匯入的表
連線資料來源是管理動作,OT Flash 把控制權放在角色裡。預置角色中,SOURCE_MANAGER 管理全部資源並對其授予許可權,SYSTEM_MANAGER 負責全域性配置和使用者,LOG_MANAGER 負責日誌審計。自定義角色按資源逐項獲得許可權,資源按類別列出(All Resources、Ontology、Data Entry)。這就是上文說的第二條邊界:資料庫賬號決定 OT Flash 能取什麼,角色決定誰能看到取回來的東西。
兩個介面把閉環收攏。日誌管理(Operate Logs)記錄登入、資料表匯入等操作,每條帶 Host、Type、Status、Detail、Operate User 和 Operate Time,可按關鍵詞、使用者、狀態、型別和時間範圍篩選;檢視需要 LOG_MANAGER 或 SYSTEM_MANAGER。資產目錄(Asset Catalog)按資料來源對錶分組,顯示其中多少張有關係、多少張是孤立的,這是檢視一個新連線帶進來了什麼、以及它們是否與別的東西連通的最快方法。
連線之前的決策表
| 問題 | 答案從哪裡來 |
|---|---|
| 我的資料庫型別受支援嗎? | r57 手冊中的 26 項列表 |
| 我的資料庫版本受支援嗎? | 未說明;在你的例項上試一次 Connect |
| OT Flash 能讀什麼? | 你的只讀賬號的授權,用引擎自己的工具核對(MySQL 上是 SHOW GRANTS) |
| 誰能看到匯入的副本? | OT Flash 的角色和逐資源許可權 |
| 資料有多新? | 你在嚮導第 3 步設定的匯入計劃 |
| 昨晚的匯入跑了嗎? | Table Task:Status 和 Last Import Time |
| 誰在什麼時候匯入了什麼? | 日誌管理(LOG_MANAGER 或 SYSTEM_MANAGER) |
| 這個連線帶進來了什麼? | 資產目錄,按資料來源分組 |
凡是答案為“未說明”的地方,那是一項要去做的測試,不是一個可以糊弄過去的空白。
什麼情況下不適合
- 你需要每個問題都從即時源資料作答、不允許有副本。手冊記載的是匯入,不是即時查詢。
- 你的資料庫型別不在這 26 種之內。檔案、API 或 HTTP 路徑也許能用,但手冊沒有說它們是等價的。
- 你需要一份經過測試的版本矩陣。手冊列的是型別,不是版本。
下一步
從一個數據源和一個 schema 開始:建立只讀賬號,連上它,匯入兩三張表,盯著 Table Task 跑完一個完整的排程週期,再往裡加。相關介面見 OT Flash 使用者手冊;手冊中心在 datafocus.ai/docs/ot-flash-r56。OT Flash 可以從版本與下載頁或 GitHub 倉庫免費下載,安裝包和發行說明都發布在那裡;系統要求和支援的平臺見發行說明。