版：從 tar.gz 到 SQL 與對象雙通道實戰(zhàn))
簡介這份資源是InterSystems IRIS社區(qū)版2021.1.0.215.3的Linux安裝包面向Ubuntu 18.04 LTS x86_64系統(tǒng)適合醫(yī)療信息化開發(fā)者、后關(guān)系型數(shù)據(jù)庫學習者及需要搭建Caché實驗環(huán)境的技術(shù)人員。Caché由InterSystems公司開發(fā)是后關(guān)系型數(shù)據(jù)庫的代表產(chǎn)品支持對象訪問、SQL訪問與多維數(shù)據(jù)數(shù)組直接訪問三種方式并可并發(fā)操作同一份數(shù)據(jù)在醫(yī)療領(lǐng)域應(yīng)用廣泛。壓縮包為gz格式整體約781.53MB上游未提供文件總數(shù)與類型明細但作為官方發(fā)行版鏡像通常包含安裝腳本、運行時組件與文檔等核心內(nèi)容。目前已有290人瀏覽學習可作為了解后關(guān)系型數(shù)據(jù)庫架構(gòu)、搭建本地開發(fā)測試環(huán)境的參考。通過該安裝包讀者可在Ubuntu環(huán)境中部署IRIS社區(qū)版進而實踐多維數(shù)據(jù)建模、SQL與對象混合訪問等典型場景為醫(yī)療數(shù)據(jù)平臺開發(fā)與選型提供一手體驗。1. 從 tar.gz 到可連的 IRIS這份社區(qū)版到底解決什么問題很多人第一次拿到IRIS_Community-2021.1.0.215.3-lnxubuntux64.tar.gz會愣一下一個數(shù)據(jù)庫為什么是壓縮包而不是 apt 源里一行命令裝完原因在于 InterSystems IRIS 的社區(qū)版走的是獨立發(fā)行包路線它把服務(wù)端、管理門戶、終端工具、驅(qū)動和一堆運行時依賴全塞進這個 tar.gz 里解壓后跑一個安裝腳本就能在一臺干凈的 Ubuntu x64 機器上拉起一套完整的后關(guān)系型數(shù)據(jù)庫。所謂后關(guān)系型指的是它既能用 SQL 訪問又能用原生對象和全局Global多維數(shù)組訪問同一份數(shù)據(jù)兩種視角這是 Caché 一脈相承的設(shè)計。這份資源適合誰想學 IRIS 但不想碰商業(yè)授權(quán)流程的開發(fā)者、要評估多模型數(shù)據(jù)庫選型的架構(gòu)師、以及需要在本地復現(xiàn)一套帶管理門戶的數(shù)據(jù)庫環(huán)境做教學或測試的人。它解決的核心訴求就一個用最低的環(huán)境成本拿到一套能連、能建庫、能跑 SQL 也能跑對象的完整實例。2. 解壓前的環(huán)境核對與安裝腳本執(zhí)行2.1 為什么先核對系統(tǒng)而不是直接解壓IRIS 社區(qū)版對操作系統(tǒng)有明確要求2021.1 這個版本面向 Ubuntu x64文件名里的lnxubuntux64已經(jīng)把平臺寫死了。常見翻車是拿它往 CentOS 或麒麟 V10 上裝glibc 版本和依賴庫對不上安裝腳本跑到一半報缺庫。所以第一步不是tar -zxvf而是確認發(fā)行版和架構(gòu)。我一般會先跑三條命令把底摸清看發(fā)行版、看內(nèi)核架構(gòu)、看可用內(nèi)存。IRIS 實例啟動后常駐內(nèi)存不小社區(qū)版雖然限制連接數(shù)和數(shù)據(jù)規(guī)模但給 4GB 以下內(nèi)存的機器裝后面管理門戶打開會非常卡。# 確認發(fā)行版與版本號必須是 Ubuntu x64 系列 cat /etc/os-release # 確認 CPU 架構(gòu)輸出必須是 x86_64 uname -m # 看內(nèi)存和磁盤建議內(nèi)存 4GB 以上磁盤預留 10GB free -h df -h /opt邏輯說明os-release里的IDubuntu和VERSION_ID決定這個包能不能裝uname -m排除 ARM 機器ARM 上這個包直接跑不起來free和df是給后面安裝目錄選位置做參考。參數(shù)上安裝目錄默認在/opt或/usr/local下磁盤緊張的話提前規(guī)劃。2.2 解壓與安裝腳本的關(guān)鍵參數(shù)確認環(huán)境沒問題后把 tar.gz 放到一個有寫權(quán)限的目錄解壓出來會看到一個irisinstall之類的腳本和一堆組件目錄。安裝腳本支持靜默和交互兩種模式生產(chǎn)或批量環(huán)境用靜默本地學習用交互更直觀。靜默安裝的核心是幾個參數(shù)安裝目錄、實例名、超級用戶密碼、以及是否隨系統(tǒng)啟動。下面這段是常見的靜默安裝寫法。# 解壓到當前目錄 tar -zxvf IRIS_Community-2021.1.0.215.3-lnxubuntux64.tar.gz # 進入解壓出的目錄目錄名以實際為準 cd IRIS_Community-2021.1.0.215.3-lnxubuntux64 # 靜默安裝指定目錄、實例名、密碼、端口 sudo ./irisinstall_silent \ ISC_PACKAGE_INSTALLDIR/opt/iris \ ISC_PACKAGE_INSTANCENAMEIRISHEALTH \ ISC_PACKAGE_UNICODEY \ ISC_PACKAGE_SUPERSERVER_PORT1972 \ ISC_PACKAGE_WEBPORT52773 \ ISC_PACKAGE_MGRUSERroot \ ISC_PACKAGE_STARTCACHEY邏輯說明ISC_PACKAGE_INSTALLDIR是安裝根目錄別選帶空格的路徑ISC_PACKAGE_INSTANCENAME是實例名后面連接串里會用到ISC_PACKAGE_SUPERSERVER_PORT是超級服務(wù)器端口默認 1972被占用就換ISC_PACKAGE_WEBPORT是管理門戶的 Web 端口默認 52773沖突時改這里ISC_PACKAGE_STARTCACHEY表示裝完自動拉起實例。密碼參數(shù)在不同小版本里名字略有差異交互模式會提示你設(shè)靜默模式如果沒傳對裝完可能連不上這是最容易踩的坑之一。2.3 裝完先驗證實例狀態(tài)安裝腳本跑完不代表實例真的起來了。我習慣立刻用iris命令查狀態(tài)再確認端口在監(jiān)聽。這一步能提前發(fā)現(xiàn)端口沖突、權(quán)限不足、依賴缺失三類問題。# 查看 IRIS 實例狀態(tài) sudo -u root iris list # 確認超級服務(wù)器端口和管理門戶端口在監(jiān)聽 ss -tlnp | grep -E 1972|52773 # 用終端工具連一下實例驗證能進 iris session IRISHEALTH邏輯說明iris list會列出實例名、安裝目錄、狀態(tài)和端口狀態(tài)是running才算成功ss確認端口真的被監(jiān)聽而不是腳本說成功但進程沒起iris session進終端后能敲Write ok出結(jié)果說明實例可用。到這一步一套能連的 IRIS 就立住了。3. 管理門戶與 SQL 雙通道上手建庫、建表、跑第一條查詢3.1 管理門戶能做什么什么時候該用它管理門戶跑在http://機器IP:52773/csp/sys/UtilHome.csp用安裝時設(shè)的超級用戶登錄。它的價值在于可視化地做系統(tǒng)管理看數(shù)據(jù)庫文件、配命名空間、管用戶權(quán)限、查進程和鎖、導數(shù)據(jù)。新手容易把它當成唯一入口其實它更適合做配置和排障日常寫 SQL 用終端或外部客戶端更快。門戶里幾個高頻位置要記住系統(tǒng)管理下的配置能改端口和內(nèi)存SQL 執(zhí)行器能直接跑語句全局查看器能看底層多維數(shù)組這是理解后關(guān)系型的關(guān)鍵窗口。3.2 用 SQL 建命名空間和表IRIS 里命名空間是邏輯隔離單位一個命名空間對應(yīng)一組數(shù)據(jù)庫文件。建表前先確認在哪個命名空間下操作。下面用 SQL 走一遍最小閉環(huán)建表、插數(shù)據(jù)、查數(shù)據(jù)。注意 IRIS 的 SQL 方言對標準 SQL 兼容度不錯但自增列、時間類型這些有自己的寫法。-- 切到用戶命名空間避免在系統(tǒng)命名空間里建業(yè)務(wù)表 -- 在 SQL 執(zhí)行器里先執(zhí)行 SET NAMESPACE USER; -- 建一張簡單表ID 用 IRIS 的自增寫法 CREATE TABLE Demo.Person ( ID INTEGER IDENTITY PRIMARY KEY, Name VARCHAR(50) NOT NULL, Age INTEGER, CreatedAt TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); -- 插兩條數(shù)據(jù) INSERT INTO Demo.Person (Name, Age) VALUES (Zhang, 30); INSERT INTO Demo.Person (Name, Age) VALUES (Li, 25); -- 查詢驗證 SELECT ID, Name, Age, CreatedAt FROM Demo.Person ORDER BY ID;邏輯說明IDENTITY是 IRIS 的自增列寫法等價于其他庫的 auto_incrementTIMESTAMP DEFAULT CURRENT_TIMESTAMP讓插入時自動填時間Demo.Person這種帶 schema 的寫法便于管理。參數(shù)上VARCHAR長度按業(yè)務(wù)定IRIS 對字符串處理比較寬松但顯式給長度是好習慣。執(zhí)行完能在結(jié)果集里看到兩行說明 SQL 通道通了。3.3 用對象視角看同一份數(shù)據(jù)后關(guān)系型的賣點在這里體現(xiàn)同一張Demo.Person表既可以用 SQL 查也可以映射成對象類來操作。IRIS 里表會自動對應(yīng)一個持久化類你可以用 ObjectScript 直接操作對象底層落到同一份 Global 數(shù)據(jù)。下面這段在終端里跑驗證對象通道。// 切到 USER 命名空間 ZN USER // 打開一條記錄按 ID 取對象 Set person ##class(Demo.Person).%OpenId(1) Write Name: , person.Name, Age: , person.Age, ! // 改一個屬性再保存回到 SQL 查會看到變化 Set person.Age 31 Do person.%Save() Write Updated., !邏輯說明%OpenId按主鍵取對象%Save落庫改完再用 SQL 查Demo.Person會發(fā)現(xiàn) Age 變成 31。這就是同一份數(shù)據(jù)兩種訪問路徑的實證。參數(shù)上ZN切命名空間別在系統(tǒng)命名空間里亂建類。到這一步SQL 和對象兩條路都跑通了選型評估時心里就有底了。4. 避坑與排查裝完連不上、端口沖突、內(nèi)存不夠的現(xiàn)場處理4.1 現(xiàn)象安裝腳本報成功但iris list顯示實例沒起來原因通常是依賴庫缺失或安裝目錄權(quán)限不對。IRIS 依賴一些系統(tǒng)庫精簡版 Ubuntu 鏡像里可能沒裝全另外安裝目錄如果歸 root 之外的用戶實例進程起不來。解決先看安裝日志一般在安裝目錄的mgr下找cconsole.log或messages.log里面會寫缺哪個庫缺庫就apt-get install補上權(quán)限問題就chown -R把安裝目錄給對應(yīng)用戶再iris start 實例名手動拉起。4.2 現(xiàn)象管理門戶打不開但終端能連原因多半是 Web 端口沒監(jiān)聽或被防火墻擋了。IRIS 的超級服務(wù)器端口和管理門戶 Web 端口是兩回事終端走前者門戶走后者。解決ss -tlnp | grep 52773確認端口在不在不在就檢查安裝時ISC_PACKAGE_WEBPORT是不是被占用后沒改在監(jiān)聽但外部訪問不了查本機防火墻規(guī)則放行對應(yīng)端口。云主機還要看安全組。4.3 現(xiàn)象跑一會兒實例變慢甚至無響應(yīng)原因是內(nèi)存不足或全局緩沖區(qū)配置偏小。IRIS 靠共享內(nèi)存做全局緩沖內(nèi)存給少了頻繁刷盤性能斷崖。解決先free -h看剩余內(nèi)存再看管理門戶里系統(tǒng)配置的共享內(nèi)存和緩沖區(qū)參數(shù)。本地學習環(huán)境把緩沖區(qū)適當調(diào)大但別超過物理內(nèi)存的合理比例否則系統(tǒng)開始換頁反而更慢。社區(qū)版本身有資源限制別指望它扛生產(chǎn)級并發(fā)。4.4 現(xiàn)象SQL 里建表報命名空間或權(quán)限錯誤原因是當前會話不在預期命名空間或用的用戶沒有建表權(quán)限。解決執(zhí)行前先SET NAMESPACE切到目標命名空間權(quán)限問題用超級用戶登錄或在管理門戶里給對應(yīng)用戶授%DB_USER之類的角色。別在%SYS系統(tǒng)命名空間里建業(yè)務(wù)表那是自找麻煩。4.5 現(xiàn)象tar.gz 解壓報錯或文件不完整原因是下載中斷或校驗沒做。大文件傳輸中斷很常見解壓時報unexpected EOF基本就是包沒下全。解決重新下載下完比對文件大小有條件的話核對官方給的校驗值。解壓前留足磁盤空間tar解到一半空間滿也會報奇怪的錯。5. 進階技巧用全局看底層數(shù)據(jù)把 IRIS 當多模型庫來評估5.1 從管理門戶的全局查看器理解存儲前面說后關(guān)系型最直觀的驗證是打開管理門戶的全局查看器找到^Demo.PersonD這類 Global。你會看到數(shù)據(jù)不是以行列表格存的而是以多維數(shù)組的稀疏樹存的第一層是 ID第二層是字段名葉子是值。SQL 表只是這棵樹的一個投影。理解這一點后面做性能調(diào)優(yōu)、數(shù)據(jù)遷移、跨模型查詢時就不會被“表”的思維框住。我一般會建議評估者做一件事建一張表插幾條數(shù)據(jù)然后去全局查看器里對照看SQL 視角和 Global 視角來回切幾次后關(guān)系型到底怎么回事就清楚了。5.2 用 SQL 和對象混合做一個最小業(yè)務(wù)閉環(huán)評估多模型庫光看單條查詢不夠要看兩種模型能不能在同一事務(wù)里協(xié)作。下面這個例子用對象取數(shù)據(jù)、用 SQL 做聚合驗證混合訪問。// 用對象方式遍歷統(tǒng)計年齡總和 ZN USER Set total 0, count 0 Set rs ##class(%SQL.Statement).%ExecDirect(, SELECT ID FROM Demo.Person) While rs.%Next() { Set p ##class(Demo.Person).%OpenId(rs.ID) Set total total p.Age Set count count 1 } Write Count: , count, TotalAge: , total, Avg: , total/count, !邏輯說明%ExecDirect跑 SQL 拿 ID 集合再用%OpenId走對象取屬性兩種訪問方式在同一次循環(huán)里混用。參數(shù)上%SQL.Statement是 IRIS 的 SQL 接口類%Next遍歷結(jié)果集。這種寫法在需要復雜對象邏輯又不想放棄 SQL 篩選能力的場景里很實用。跑通它你對這套庫的評估就從“能裝”進到“能用”了。5.3 連接外部客戶端的注意點用 JDBC 或 ODBC 從外部程序連 IRIS端口填超級服務(wù)器端口默認 1972不是 Web 端口。驅(qū)動在安裝目錄的dev或bin下能找到。連接串里命名空間要寫對否則默認進%SYS會一臉懵。我踩過的坑是拿 Web 端口去連 JDBC怎么都連不上后來才反應(yīng)過來兩個端口各管各的。從那以后我每次配連接串都強制先確認端口用途再填命名空間最后才寫業(yè)務(wù)代碼。希望幫到你。本文還有配套的精品資源點擊獲取 Ubuntu 上部署 InterSystems IRIS 社區(qū)版：從 tar.gz 到 SQL 與對象雙通道實戰(zhàn)
簡介這份資源是InterSystems IRIS社區(qū)版2021.1.0.215.3的Linux安裝包面向Ubuntu 18.04 LTS x86_64系統(tǒng)適合醫(yī)療信息化開發(fā)者、后關(guān)系型數(shù)據(jù)庫學習者及需要搭建Caché實驗環(huán)境的技術(shù)人員。Caché由InterSystems公司開發(fā)是后關(guān)系型數(shù)據(jù)庫的代表產(chǎn)品支持對象訪問、SQL訪問與多維數(shù)據(jù)數(shù)組直接訪問三種方式并可并發(fā)操作同一份數(shù)據(jù)在醫(yī)療領(lǐng)域應(yīng)用廣泛。壓縮包為gz格式整體約781.53MB上游未提供文件總數(shù)與類型明細但作為官方發(fā)行版鏡像通常包含安裝腳本、運行時組件與文檔等核心內(nèi)容。目前已有290人瀏覽學習可作為了解后關(guān)系型數(shù)據(jù)庫架構(gòu)、搭建本地開發(fā)測試環(huán)境的參考。通過該安裝包讀者可在Ubuntu環(huán)境中部署IRIS社區(qū)版進而實踐多維數(shù)據(jù)建模、SQL與對象混合訪問等典型場景為醫(yī)療數(shù)據(jù)平臺開發(fā)與選型提供一手體驗。1. 從 tar.gz 到可連的 IRIS這份社區(qū)版到底解決什么問題很多人第一次拿到IRIS_Community-2021.1.0.215.3-lnxubuntux64.tar.gz會愣一下一個數(shù)據(jù)庫為什么是壓縮包而不是 apt 源里一行命令裝完原因在于 InterSystems IRIS 的社區(qū)版走的是獨立發(fā)行包路線它把服務(wù)端、管理門戶、終端工具、驅(qū)動和一堆運行時依賴全塞進這個 tar.gz 里解壓后跑一個安裝腳本就能在一臺干凈的 Ubuntu x64 機器上拉起一套完整的后關(guān)系型數(shù)據(jù)庫。所謂后關(guān)系型指的是它既能用 SQL 訪問又能用原生對象和全局Global多維數(shù)組訪問同一份數(shù)據(jù)兩種視角這是 Caché 一脈相承的設(shè)計。這份資源適合誰想學 IRIS 但不想碰商業(yè)授權(quán)流程的開發(fā)者、要評估多模型數(shù)據(jù)庫選型的架構(gòu)師、以及需要在本地復現(xiàn)一套帶管理門戶的數(shù)據(jù)庫環(huán)境做教學或測試的人。它解決的核心訴求就一個用最低的環(huán)境成本拿到一套能連、能建庫、能跑 SQL 也能跑對象的完整實例。2. 解壓前的環(huán)境核對與安裝腳本執(zhí)行2.1 為什么先核對系統(tǒng)而不是直接解壓IRIS 社區(qū)版對操作系統(tǒng)有明確要求2021.1 這個版本面向 Ubuntu x64文件名里的lnxubuntux64已經(jīng)把平臺寫死了。常見翻車是拿它往 CentOS 或麒麟 V10 上裝glibc 版本和依賴庫對不上安裝腳本跑到一半報缺庫。所以第一步不是tar -zxvf而是確認發(fā)行版和架構(gòu)。我一般會先跑三條命令把底摸清看發(fā)行版、看內(nèi)核架構(gòu)、看可用內(nèi)存。IRIS 實例啟動后常駐內(nèi)存不小社區(qū)版雖然限制連接數(shù)和數(shù)據(jù)規(guī)模但給 4GB 以下內(nèi)存的機器裝后面管理門戶打開會非常卡。# 確認發(fā)行版與版本號必須是 Ubuntu x64 系列 cat /etc/os-release # 確認 CPU 架構(gòu)輸出必須是 x86_64 uname -m # 看內(nèi)存和磁盤建議內(nèi)存 4GB 以上磁盤預留 10GB free -h df -h /opt邏輯說明os-release里的IDubuntu和VERSION_ID決定這個包能不能裝uname -m排除 ARM 機器ARM 上這個包直接跑不起來free和df是給后面安裝目錄選位置做參考。參數(shù)上安裝目錄默認在/opt或/usr/local下磁盤緊張的話提前規(guī)劃。2.2 解壓與安裝腳本的關(guān)鍵參數(shù)確認環(huán)境沒問題后把 tar.gz 放到一個有寫權(quán)限的目錄解壓出來會看到一個irisinstall之類的腳本和一堆組件目錄。安裝腳本支持靜默和交互兩種模式生產(chǎn)或批量環(huán)境用靜默本地學習用交互更直觀。靜默安裝的核心是幾個參數(shù)安裝目錄、實例名、超級用戶密碼、以及是否隨系統(tǒng)啟動。下面這段是常見的靜默安裝寫法。# 解壓到當前目錄 tar -zxvf IRIS_Community-2021.1.0.215.3-lnxubuntux64.tar.gz # 進入解壓出的目錄目錄名以實際為準 cd IRIS_Community-2021.1.0.215.3-lnxubuntux64 # 靜默安裝指定目錄、實例名、密碼、端口 sudo ./irisinstall_silent \ ISC_PACKAGE_INSTALLDIR/opt/iris \ ISC_PACKAGE_INSTANCENAMEIRISHEALTH \ ISC_PACKAGE_UNICODEY \ ISC_PACKAGE_SUPERSERVER_PORT1972 \ ISC_PACKAGE_WEBPORT52773 \ ISC_PACKAGE_MGRUSERroot \ ISC_PACKAGE_STARTCACHEY邏輯說明ISC_PACKAGE_INSTALLDIR是安裝根目錄別選帶空格的路徑ISC_PACKAGE_INSTANCENAME是實例名后面連接串里會用到ISC_PACKAGE_SUPERSERVER_PORT是超級服務(wù)器端口默認 1972被占用就換ISC_PACKAGE_WEBPORT是管理門戶的 Web 端口默認 52773沖突時改這里ISC_PACKAGE_STARTCACHEY表示裝完自動拉起實例。密碼參數(shù)在不同小版本里名字略有差異交互模式會提示你設(shè)靜默模式如果沒傳對裝完可能連不上這是最容易踩的坑之一。2.3 裝完先驗證實例狀態(tài)安裝腳本跑完不代表實例真的起來了。我習慣立刻用iris命令查狀態(tài)再確認端口在監(jiān)聽。這一步能提前發(fā)現(xiàn)端口沖突、權(quán)限不足、依賴缺失三類問題。# 查看 IRIS 實例狀態(tài) sudo -u root iris list # 確認超級服務(wù)器端口和管理門戶端口在監(jiān)聽 ss -tlnp | grep -E 1972|52773 # 用終端工具連一下實例驗證能進 iris session IRISHEALTH邏輯說明iris list會列出實例名、安裝目錄、狀態(tài)和端口狀態(tài)是running才算成功ss確認端口真的被監(jiān)聽而不是腳本說成功但進程沒起iris session進終端后能敲Write ok出結(jié)果說明實例可用。到這一步一套能連的 IRIS 就立住了。3. 管理門戶與 SQL 雙通道上手建庫、建表、跑第一條查詢3.1 管理門戶能做什么什么時候該用它管理門戶跑在http://機器IP:52773/csp/sys/UtilHome.csp用安裝時設(shè)的超級用戶登錄。它的價值在于可視化地做系統(tǒng)管理看數(shù)據(jù)庫文件、配命名空間、管用戶權(quán)限、查進程和鎖、導數(shù)據(jù)。新手容易把它當成唯一入口其實它更適合做配置和排障日常寫 SQL 用終端或外部客戶端更快。門戶里幾個高頻位置要記住系統(tǒng)管理下的配置能改端口和內(nèi)存SQL 執(zhí)行器能直接跑語句全局查看器能看底層多維數(shù)組這是理解后關(guān)系型的關(guān)鍵窗口。3.2 用 SQL 建命名空間和表IRIS 里命名空間是邏輯隔離單位一個命名空間對應(yīng)一組數(shù)據(jù)庫文件。建表前先確認在哪個命名空間下操作。下面用 SQL 走一遍最小閉環(huán)建表、插數(shù)據(jù)、查數(shù)據(jù)。注意 IRIS 的 SQL 方言對標準 SQL 兼容度不錯但自增列、時間類型這些有自己的寫法。-- 切到用戶命名空間避免在系統(tǒng)命名空間里建業(yè)務(wù)表 -- 在 SQL 執(zhí)行器里先執(zhí)行 SET NAMESPACE USER; -- 建一張簡單表ID 用 IRIS 的自增寫法 CREATE TABLE Demo.Person ( ID INTEGER IDENTITY PRIMARY KEY, Name VARCHAR(50) NOT NULL, Age INTEGER, CreatedAt TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); -- 插兩條數(shù)據(jù) INSERT INTO Demo.Person (Name, Age) VALUES (Zhang, 30); INSERT INTO Demo.Person (Name, Age) VALUES (Li, 25); -- 查詢驗證 SELECT ID, Name, Age, CreatedAt FROM Demo.Person ORDER BY ID;邏輯說明IDENTITY是 IRIS 的自增列寫法等價于其他庫的 auto_incrementTIMESTAMP DEFAULT CURRENT_TIMESTAMP讓插入時自動填時間Demo.Person這種帶 schema 的寫法便于管理。參數(shù)上VARCHAR長度按業(yè)務(wù)定IRIS 對字符串處理比較寬松但顯式給長度是好習慣。執(zhí)行完能在結(jié)果集里看到兩行說明 SQL 通道通了。3.3 用對象視角看同一份數(shù)據(jù)后關(guān)系型的賣點在這里體現(xiàn)同一張Demo.Person表既可以用 SQL 查也可以映射成對象類來操作。IRIS 里表會自動對應(yīng)一個持久化類你可以用 ObjectScript 直接操作對象底層落到同一份 Global 數(shù)據(jù)。下面這段在終端里跑驗證對象通道。// 切到 USER 命名空間 ZN USER // 打開一條記錄按 ID 取對象 Set person ##class(Demo.Person).%OpenId(1) Write Name: , person.Name, Age: , person.Age, ! // 改一個屬性再保存回到 SQL 查會看到變化 Set person.Age 31 Do person.%Save() Write Updated., !邏輯說明%OpenId按主鍵取對象%Save落庫改完再用 SQL 查Demo.Person會發(fā)現(xiàn) Age 變成 31。這就是同一份數(shù)據(jù)兩種訪問路徑的實證。參數(shù)上ZN切命名空間別在系統(tǒng)命名空間里亂建類。到這一步SQL 和對象兩條路都跑通了選型評估時心里就有底了。4. 避坑與排查裝完連不上、端口沖突、內(nèi)存不夠的現(xiàn)場處理4.1 現(xiàn)象安裝腳本報成功但iris list顯示實例沒起來原因通常是依賴庫缺失或安裝目錄權(quán)限不對。IRIS 依賴一些系統(tǒng)庫精簡版 Ubuntu 鏡像里可能沒裝全另外安裝目錄如果歸 root 之外的用戶實例進程起不來。解決先看安裝日志一般在安裝目錄的mgr下找cconsole.log或messages.log里面會寫缺哪個庫缺庫就apt-get install補上權(quán)限問題就chown -R把安裝目錄給對應(yīng)用戶再iris start 實例名手動拉起。4.2 現(xiàn)象管理門戶打不開但終端能連原因多半是 Web 端口沒監(jiān)聽或被防火墻擋了。IRIS 的超級服務(wù)器端口和管理門戶 Web 端口是兩回事終端走前者門戶走后者。解決ss -tlnp | grep 52773確認端口在不在不在就檢查安裝時ISC_PACKAGE_WEBPORT是不是被占用后沒改在監(jiān)聽但外部訪問不了查本機防火墻規(guī)則放行對應(yīng)端口。云主機還要看安全組。4.3 現(xiàn)象跑一會兒實例變慢甚至無響應(yīng)原因是內(nèi)存不足或全局緩沖區(qū)配置偏小。IRIS 靠共享內(nèi)存做全局緩沖內(nèi)存給少了頻繁刷盤性能斷崖。解決先free -h看剩余內(nèi)存再看管理門戶里系統(tǒng)配置的共享內(nèi)存和緩沖區(qū)參數(shù)。本地學習環(huán)境把緩沖區(qū)適當調(diào)大但別超過物理內(nèi)存的合理比例否則系統(tǒng)開始換頁反而更慢。社區(qū)版本身有資源限制別指望它扛生產(chǎn)級并發(fā)。4.4 現(xiàn)象SQL 里建表報命名空間或權(quán)限錯誤原因是當前會話不在預期命名空間或用的用戶沒有建表權(quán)限。解決執(zhí)行前先SET NAMESPACE切到目標命名空間權(quán)限問題用超級用戶登錄或在管理門戶里給對應(yīng)用戶授%DB_USER之類的角色。別在%SYS系統(tǒng)命名空間里建業(yè)務(wù)表那是自找麻煩。4.5 現(xiàn)象tar.gz 解壓報錯或文件不完整原因是下載中斷或校驗沒做。大文件傳輸中斷很常見解壓時報unexpected EOF基本就是包沒下全。解決重新下載下完比對文件大小有條件的話核對官方給的校驗值。解壓前留足磁盤空間tar解到一半空間滿也會報奇怪的錯。5. 進階技巧用全局看底層數(shù)據(jù)把 IRIS 當多模型庫來評估5.1 從管理門戶的全局查看器理解存儲前面說后關(guān)系型最直觀的驗證是打開管理門戶的全局查看器找到^Demo.PersonD這類 Global。你會看到數(shù)據(jù)不是以行列表格存的而是以多維數(shù)組的稀疏樹存的第一層是 ID第二層是字段名葉子是值。SQL 表只是這棵樹的一個投影。理解這一點后面做性能調(diào)優(yōu)、數(shù)據(jù)遷移、跨模型查詢時就不會被“表”的思維框住。我一般會建議評估者做一件事建一張表插幾條數(shù)據(jù)然后去全局查看器里對照看SQL 視角和 Global 視角來回切幾次后關(guān)系型到底怎么回事就清楚了。5.2 用 SQL 和對象混合做一個最小業(yè)務(wù)閉環(huán)評估多模型庫光看單條查詢不夠要看兩種模型能不能在同一事務(wù)里協(xié)作。下面這個例子用對象取數(shù)據(jù)、用 SQL 做聚合驗證混合訪問。// 用對象方式遍歷統(tǒng)計年齡總和 ZN USER Set total 0, count 0 Set rs ##class(%SQL.Statement).%ExecDirect(, SELECT ID FROM Demo.Person) While rs.%Next() { Set p ##class(Demo.Person).%OpenId(rs.ID) Set total total p.Age Set count count 1 } Write Count: , count, TotalAge: , total, Avg: , total/count, !邏輯說明%ExecDirect跑 SQL 拿 ID 集合再用%OpenId走對象取屬性兩種訪問方式在同一次循環(huán)里混用。參數(shù)上%SQL.Statement是 IRIS 的 SQL 接口類%Next遍歷結(jié)果集。這種寫法在需要復雜對象邏輯又不想放棄 SQL 篩選能力的場景里很實用。跑通它你對這套庫的評估就從“能裝”進到“能用”了。5.3 連接外部客戶端的注意點用 JDBC 或 ODBC 從外部程序連 IRIS端口填超級服務(wù)器端口默認 1972不是 Web 端口。驅(qū)動在安裝目錄的dev或bin下能找到。連接串里命名空間要寫對否則默認進%SYS會一臉懵。我踩過的坑是拿 Web 端口去連 JDBC怎么都連不上后來才反應(yīng)過來兩個端口各管各的。從那以后我每次配連接串都強制先確認端口用途再填命名空間最后才寫業(yè)務(wù)代碼。希望幫到你。本文還有配套的精品資源點擊獲取