Net.Data 語言環境參考手冊

Sybase 語言環境

Sybase 語言環境讓您以原本的方式存取 Sybase 資料。 您可以從以 CGI、FastCGI、NSAPI、ISAPI 或 GWAPI 模式執行的 Net.Data 來存取 Sybase 表格。

限制：

• Sybase 語言環境不支援大型物件如影像或音效。 只有對不具有 SELECT 陳述式的程序支援儲存程序。

• Sybase 語言環境需要「現場連線」使用 FastCGI。

欲從 Net.Data 存取 Sybase，請：

1. 驗證 Net.Data 起始設定檔中的 ENVIRONMENT 陳述式就 Sybase 語言環境而言是否正確。 步驟及範例的相關資訊，請參閱 Net.Data 管理及程式設計手冊 中的架構章節。

2. 請確定您已安裝適當的 Sybase 組件，而且其運作如下：

   1. 如果安裝 Net.Data 的機器上尚未安裝 Sybase's Open Client， 則請安裝。相關資訊，請參閱 Sybase Open Client 文件。

   2. 驗證 Sybase ping 函數是否可用與 Web 伺服器所使用的同一個安全性權限來使用。 若要驗證，請用您的 Web 伺服器的使用者 ID 登入，並鍵入：

      ping sybase-instance-name
      

      其中 sybase-instance-name 是您的 Net.Data 巨集所存取之 Sybase 系統的名稱。

      如果您的 Web 伺服器是在系統權限之下執行， 您可能就無法驗證 Windows NT 上的 ping 函數。 如果真是如此，則跳過這個步驟。

   3. 驗證 Sybase 表格可以用 Web 伺服器所使用的同一個安全性權限來存取。 欲驗證，請用 ISQL 字行指令工具來輸入 SQL SELECT 陳述式， 以用您 Web 伺服器權限來存取 Sybase 表格。例如：

      SELECT * FROM tablename
      

      如果您的 Web 伺服器是在系統權限之下執行， 您可能就無法驗證 Windows NT 上的表格存取。 如果真是如此，則跳過這個步驟。

   疑難排解：如果上述步驟失敗，則請勿繼續。 如果有任何步驟失敗，請檢查您的 Sybase 架構。

3. 確定 Sybase 環境變數皆已正確地設定在您的 Web 伺服器處理程序中。

   • 若您使用 AIX，請將下列字行放置在 /etc/environment 檔案中：

     DSQUERY=sybase-instance-name
     SYBASE=sybase-runtime-library-directory
     

   • 若您使用 Windows NT，請用「系統性質控制台」來新增下列環境變數：

     DSQUERY=sybase-instance-name
     SYBASE=sybase-runtime-library-directory
     

   暗示：您可能會需要額外的字行來供其他 Sybase 環境變數使用， 而這些字行需視您所計畫使用的 Sybase 機能而定，例如國家語言支援及二階段確認寫入。 這些環境變數的相關資訊，請參閱 Sybase 管理文件。

4. 測試從 Net.Data 至 Sybase 的連線。在您的 Net.Data 巨集檔中， 在 LOGIN、PASSWORD 及 DATABASE 變數中指定適當的數值。 下列為巨集檔中連接陳述式的範例：

   %DEFINE DATABASE=database-name
   %DEFINE LOGIN=user_ID@remote-sybase-instance-name
   %DEFINE PASSWORD=password 
   

   現場連線：如果您使用「現場連線」， 您就可以在「現場連線」架構檔中指定 LOGIN 及 PASSWORD， 雖然基於安全性目的，我們不建議您這樣做。例如：

   DATABASE=database-name
   LOGIN=user_ID
   PASSWORD=password
   

5. 執行 CGI shell script 來測試您的架構， 以確定可以從您的 Web 伺服器存取 Sybase 案例，如下列範例所示：

   #! /bin/sh
   echo "content-type; text/html
   echo
   echo "< html>< pre>"
   set
   echo "</pre>< p>< pre>"
   isql -u user_ID -p password << EOFF
   SELECT * FROM tablename
   EOFF
   echo
   

   疑難排解：

   如果驗證步驟失敗，請檢查是否所有的進行步驟都已順利完成，驗證方法如下：

   • 檢查您的 Sybase 架構。

   • 驗證 Sybase 環境變數語法是否正確，並驗證沒有缺少任何變數。

   • 檢查 Sybase 連線，確定您輸入的使用者 ID 和通行碼是正確的。
   如果驗證步驟仍失敗，請聯絡「IBM 服務人員」。

範例：

在您完成存取驗證步驟之後，您可以用巨集檔中的函數來呼叫 Sybase 語言環境， 如下列範例所示：

%function(DTW_SYB) STL1() {
insert into $(tablename) (int1,int2) values (111,NULL)
%}