[20240814]oracle 21c NLS_DATE_FORMAT設定問題(整理版本1).txt

lfree發表於2024-08-16
OracleORM
[20240814]oracle 21c NLS_DATE_FORMAT設定問題(整理版本1).txt

--//朋友遇到的問題，請求遠端協助解決問題：
--//執行sqlplus出現如下錯誤：
SQL*Plus: Release 21.0.0.0.0 - Production on Sat Aug 10 11:38:06 2024
Version 21.3.0.0.0

Copyright (c) 1982, 2021, Oracle. All rights reserved.

Connected.
~~~~~~~~~
SQL> select sysdate from dual ;
select sysdate from dual
*
ERROR at line 1:
ORA-01012: not logged on
Process ID: 0
Session ID: 0 Serial number: 0
--//我開始懷疑對方系統是否是安裝防水牆或者防火牆之類導致的問題，我以前在生產系統也遇到類似問題，出現Connected.實際上正常
--//登入不會出現該提示。
--//幸好我即時發現NLS引數設定有單引號(注windows機器連線linux伺服器)，正好對方前幾十分鐘做了增加NLS*環境變數的操作，建議
--//他取消看看，問題馬上解決,在windows下設定NLS環境變數不需要使用單雙引號。
--//也提醒遇到問題要冷靜,想想自己做了什麼改動,這樣能很快定位問題.

--//正好沒事,在自己的測試環境重複演示遇到的問題,結果遇到自己一些問題.

1.環境:
SYS@192.168.56.101:1521/book> @ prxx
==============================
PORT_STRING : x86_64/Linux 2.4.xx
VERSION : 21.0.0.0.0
BANNER : Oracle Database 21c Enterprise Edition Release 21.0.0.0.0 - Production
BANNER_FULL : Oracle Database 21c Enterprise Edition Release 21.0.0.0.0 - Production
Version 21.3.0.0.0
BANNER_LEGACY : Oracle Database 21c Enterprise Edition Release 21.0.0.0.0 - Production
CON_ID : 0
PL/SQL procedure successfully completed.

2.建立測試環境需要檔案：
D:\tmp\study> cat nls.bat
rem @ echo off
set NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
set NLS_TIMESTAMP_FORMAT='YYYY-MM-DD HH24:MI:SS.FF'
set NLS_TIMESTAMP_TZ_FORMAT='YYYY-MM-DD HH24:MI:SS.FF TZH:TZM'
echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
--//注:使用單引號,這樣設定無法登入.
--//後面的內容為了避免重複，我直接貼出nls.bat的執行結果,不再貼出nls.bat的內容.

3.測試(單引號):
d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT='YYYY-MM-DD HH24:MI:SS.FF'
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT='YYYY-MM-DD HH24:MI:SS.FF TZH:TZM'
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
ERROR:
ORA-00604: error occurred at recursive SQL level 1
ORA-02248: invalid option for ALTER SESSION
SP2-0751: Unable to connect to Oracle. Exiting SQL*Plus
--//這裡注意一個細節,前面使用sys登入執行,報錯ORA-01012: not logged on.而這裡使用system使用者登入,報錯出現ORA-02248:
--//invalid option for ALTER SESSION,至少給一個提示可能知道可能是設定環境變數錯誤.

d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l sys/bookbook@192.168.56.101:1521/book as sysdba
select sysdate,systimestamp,localtimestamp from dual
*
ERROR at line 1:
ORA-01012: not logged on
Process ID: 0
Session ID: 0 Serial number: 0
--//錯誤提示是ORA-01012: not logged on。
--//後面的測試使用system使用者登入。

4.測試(雙引號):
d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set NLS_DATE_FORMAT="YYYY-MM-DD HH24:MI:SS"
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT="YYYY-MM-DD HH24:MI:SS.FF"
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT="YYYY-MM-DD HH24:MI:SS.FF TZH:TZM"
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
SYSDATE SYSTIMESTAMP LOCALTIMESTAMP
------------------- -------------------------------- ------------------------
2024-08-14 15:18:27 YYYY-MM-DD HH24:MI:SS.FF TZH:TZM YYYY-MM-DD HH24:MI:SS.FF

--//居然執行成功,如果沒有做這個測試,也許就沒有後面的許多事情,浪費大量的時間分析為什麼?
--//很明顯這樣設定可以登入,我開始不理解的是為什麼sysdate可以正常的輸出時間,而SYSTIMESTAMP,LOCALTIMESTAMP卻可以輸出正常格
--//式.

--//於是我修改nls.bat指令碼,在括號內加入一些內容:
d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set NLS_DATE_FORMAT="1234YYYY-MM-DD HH24:MI:SS"
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT="1234YYYY-MM-DD HH24:MI:SS.FF"
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT="1234YYYY-MM-DD HH24:MI:SS.FF TZH:TZM"
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
SYSDATE SYSTIMESTAMP LOCALTIMESTAMP
------------------- ------------------------------------ ----------------------------
2024-08-14 15:24:12 1234YYYY-MM-DD HH24:MI:SS.FF TZH:TZM 1234YYYY-MM-DD HH24:MI:SS.FF

SYSTEM@192.168.56.101:1521/book> show parameter nls_
PARAMETER_NAME TYPE VALUE
------------------------ ------ -----------------------------------------
nls_calendar string GREGORIAN
nls_comp string BINARY
nls_currency string $
nls_date_format string YYYY-MM-DD HH24:MI:SS
nls_date_language string AMERICAN
nls_dual_currency string $
nls_iso_currency string AMERICA
nls_language string AMERICAN
nls_length_semantics string BYTE
nls_nchar_conv_excp string FALSE
nls_numeric_characters string .,
nls_sort string BINARY
nls_territory string AMERICA
nls_time_format string HH24:MI:SSXFF
nls_time_tz_format string HH24.MI.SSXFF TZH:TZM
nls_timestamp_format string "1234YYYY-MM-DD HH24:MI:SS.FF"
nls_timestamp_tz_format string "1234YYYY-MM-DD HH24:MI:SS.FF TZH:TZM"

--//於是我開始懷疑nls_date_format被重置了.直到我做了alter system set events '10046 trace name context forever, level 12';
--//整個過程略(浪費大量時間).是因為環境變數設定ORACLE_PATH,SQL_PATH,路徑裡面呼叫了tanel poder的tpt的login.sql指令碼,
--//login.sql又呼叫init.sql.

d:\tmp\study> cat d:\tools\sqllaji\tpt\login.sql
cat d:\tools\sqllaji\tpt\login.sql
-- Copyright 2018 Tanel Poder. All rights reserved. More info at http://tanelpoder.com
-- Licensed under the Apache License, Version 2.0. See LICENSE.txt for terms & conditions.

-- calling init.sql which will set up sqlpus variables
@init.sql
-- i.sql is the "who am i" script which shows your session/instance info and
-- also sets command prompt window/xterm title
-- @i.sql

-- you can put your own login scripts here

d:\tmp\study> grep alter d:\tools\sqllaji\tpt\init.sql
alter session set nls_date_format = 'YYYY-MM-DD HH24:MI:SS';

--//tpt的指令碼初始化會重新設定nls_date_format = 'YYYY-MM-DD HH24:MI:SS';

d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set NLS_DATE_FORMAT="1234YYYY-MM-DD HH24:MI:SS"
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT="1234YYYY-MM-DD HH24:MI:SS.FF"
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT="1234YYYY-MM-DD HH24:MI:SS.FF TZH:TZM"
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l -R 3 system/bookbook@192.168.56.101:1521/book
SP2-0738: Restricted command "@@ (START)" not available
SP2-0738: Restricted command "@@ (START)" not available

SYSDATE
-------------------------
SYSTIMESTAMP
---------------------------------------------------------------------------
LOCALTIMESTAMP
---------------------------------------------------------------------------
1234YYYY-MM-DD HH24:MI:SS
1234YYYY-MM-DD HH24:MI:SS.FF TZH:TZM
1234YYYY-MM-DD HH24:MI:SS.FF
--//給sqlplus 加入-R 3 引數避開@之類的呼叫.現在輸出都出現了日期格式.
--//我在這裡走了很大的彎路,最終定位環境變數設定ORACLE_PATH,SQL_PATH路徑裡面呼叫了tanel poder的tpt的login.sql指令碼.
--//後面的測試我修改nls.bat指令碼,重置ORACLE_PATH,SQLPATH=來規避這個問題,注意這樣還是會執行oracle的
--//E:\tools\database21c\sqlplus\admin的glogin.sql的呼叫.
set ORACLE_PATH=
set SQLPATH=

5.如果使用1個雙引號可以登入，嘗試2個雙引號呢？
--//使用兩個雙引號看看.實際上當時思維混亂，有點在亂嘗試。
d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set ORACLE_PATH=
d:\tmp\study>set SQLPATH=
d:\tmp\study>set NLS_DATE_FORMAT=""YYYY-MM-DD HH24:MI:SS""
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT=""YYYY-MM-DD HH24:MI:SS.FF""
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT=""YYYY-MM-DD HH24:MI:SS.FF TZH:TZM""
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
SYSDATE SYSTIMESTAMP
------------------- --------------------------------------------------------------------------- -----------------------------------------
2024-08-14 15:47:21 2024-08-14 15:47:21.156656 +08:00 2024-08-14 15:47:21.156659
--//居然成功了.
--//注意1個細節.標題沒有localtimestamp.遇到1個怪問題.
--//注:有時候輸出太長,為了方便閱讀,會做一些排版,縮小寬度,但是在這裡我原樣貼出.

d:\tmp\study>echo select systimestamp,localtimestamp,sysdate from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
SYSTIMESTAMP LOCA
--------------------------------------------------------------------------- --------------------------------------------------------------------------- -------------------
2024-08-14 15:57:42.611420 +08:00 2024-08-14 15:57:42.611423 2024-08-14 15:57:42
--//輸出順序換一下,sysdate到最後.
--//如果你使用vi定位到LOCA可以發現正常在80列.但是為什麼這樣不理解,我做spool也是這樣.為什麼?

SYSTEM@192.168.56.101:1521/book> column value format a40
SYSTEM@192.168.56.101:1521/book> select * from v$nls_parameters ;
PARAMETER VALUE CON_ID
------------------------------ ---------------------------------------- ----------
NLS_LANGUAGE AMERICAN 1
NLS_TERRITORY AMERICA 1
NLS_CURRENCY $ 1
NLS_ISO_CURRENCY AMERICA 1
NLS_NUMERIC_CHARACTERS ., 1
NLS_CALENDAR GREGORIAN 1
NLS_DATE_FORMAT ""YYYY-MM-DD HH24:MI:SS"" 1
NLS_DATE_LANGUAGE AMERICAN 1
NLS_CHARACTERSET ZHS16GBK 1
NLS_SORT BINARY 1
NLS_TIME_FORMAT HH24:MI:SSXFF 1
NLS_TIMESTAMP_FORMAT ""YYYY-MM-DD HH24:MI:SS.FF"" 1
NLS_TIME_TZ_FORMAT HH24.MI.SSXFF TZH:TZM 1
NLS_TIMESTAMP_TZ_FORMAT ""YYYY-MM-DD HH24:MI:SS.FF TZH:TZM"" 1
NLS_DUAL_CURRENCY $ 1
NLS_NCHAR_CHARACTERSET AL16UTF16 1
NLS_COMP BINARY 1
NLS_LENGTH_SEMANTICS BYTE 1
NLS_NCHAR_CONV_EXCP FALSE 1
19 rows selected.
--//格式裡面記錄的是2個雙引號。

6.有了雙引號的先例,嘗試2個單引號呢？

d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set ORACLE_PATH=
d:\tmp\study>set SQLPATH=
d:\tmp\study>set NLS_DATE_FORMAT=''YYYY-MM-DD HH24:MI:SS''
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT=''YYYY-MM-DD HH24:MI:SS.FF''
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT=''YYYY-MM-DD HH24:MI:SS.FF TZH:TZM''
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
SYSDATE SYSTIMESTAMP
--------------------- --------------------------------------------------------------------------- ---------------------------------------------------------------------------
'2024-08-14 15:56:01' '2024-08-14 15:56:01.616523 +08:00' '2024-08-14 15:56:01.616526'
--//SYSDATE,SYSTIMESTAMP,LOCALTIMESTAMP的輸出包含引號.內容對的.
--//注意1個細節.標題沒有localtimestamp.不理解.

SYSTEM@192.168.56.101:1521/book> column value format a40
SYSTEM@192.168.56.101:1521/book> select * from v$nls_parameters ;
PARAMETER VALUE CON_ID
------------------------------ ---------------------------------------- ----------
NLS_LANGUAGE AMERICAN 1
NLS_TERRITORY AMERICA 1
NLS_CURRENCY $ 1
NLS_ISO_CURRENCY AMERICA 1
NLS_NUMERIC_CHARACTERS ., 1
NLS_CALENDAR GREGORIAN 1
NLS_DATE_FORMAT 'YYYY-MM-DD HH24:MI:SS' 1
NLS_DATE_LANGUAGE AMERICAN 1
NLS_CHARACTERSET ZHS16GBK 1
NLS_SORT BINARY 1
NLS_TIME_FORMAT HH24:MI:SSXFF 1
NLS_TIMESTAMP_FORMAT 'YYYY-MM-DD HH24:MI:SS.FF' 1
NLS_TIME_TZ_FORMAT HH24.MI.SSXFF TZH:TZM 1
NLS_TIMESTAMP_TZ_FORMAT 'YYYY-MM-DD HH24:MI:SS.FF TZH:TZM' 1
NLS_DUAL_CURRENCY $ 1
NLS_NCHAR_CHARACTERSET AL16UTF16 1
NLS_COMP BINARY 1
NLS_LENGTH_SEMANTICS BYTE 1
NLS_NCHAR_CONV_EXCP FALSE 1
19 rows selected.

SYSTEM@192.168.56.101:1521/book> select "DUMMY",'DUMMY' c10 from "DUAL";
D C10
- ----------
X DUMMY
--//單引號定義的是字串,而雙引號定義的欄位.

7.繼續探究:
--//突然想環境變數NLS引數的定義相當於使用特定的格式輸出.可以理解為使用了函式to_char來格式化輸出,測試並且驗證看看我的判
--//斷是否正確.

SYSTEM@192.168.56.101:1521/book> select to_char(localtimestamp,''YYYY-MM-DD HH24:MI:SS.FF'') c30 from dual;
SP2-0552: Bind variable "MI" not declared.
--//單個引號,報SP2-0552: Bind variable "MI" not declared.

SYSTEM@192.168.56.101:1521/book> select to_char(localtimestamp,''YYYY-MM-DD HH24MISS.FF'') c30 from dual;
select to_char(localtimestamp,''YYYY-MM-DD HH24MISS.FF'') c30 from dual
*
ERROR at line 1:
ORA-00907: missing right parenthesis
--//單個引號,取消:,還是報錯.說明使用單個引號會報錯.

SYSTEM@192.168.56.101:1521/book> select to_char(localtimestamp,'"YYYY-MM-DD HH24:MI:SS.FF"') c30 from dual;
C30
------------------------------
YYYY-MM-DD HH24:MI:SS.FF
--//單個雙引號,輸出日期格式,感覺自己判斷是對的.

SYSTEM@192.168.56.101:1521/book> select to_char(localtimestamp,'""YYYY-MM-DD HH24:MI:SS.FF""') c30 from dual;
C30
------------------------------
2024-08-14 16:17:24.995349

SYSTEM@192.168.56.101:1521/book> select '""1234abc""' c30 from dual;
C30
------------------------------
""1234abc""
--//2個雙引號,輸出正確,與前面測試一樣.但是我不理解.....

SYSTEM@192.168.56.101:1521/book> select to_char(localtimestamp,'''YYYY-MM-DD HH24MISS.FF''') c30 from dual;
C30
------------------------------
'2024-08-14 161952.893218'
--//2個單引號,可以理解裡面''解析為1個單引號,這樣結果輸出結果帶有單引號.

8.奇葩的例子:
--//在windows下定義環境變數不需要使用單雙引號,不像linux的定義環境變數字串有空格,一定要使用單雙引號,例子:
$ export NLS_DATE_FORMAT=YYYY-MM-DD HH24:MI:SS
-bash: export: `HH24:MI:SS': not a valid identifier

$ export NLS_DATE_FORMAT=YYYY-MM-DD:HH24:MI:SS
--//沒有空格沒事!!

--//如果那位在windows下定義環境變數結尾暗藏空格呢?
d:\tmp\study>cat -Ev nls.bat
rem @ echo off^M$
set ORACLE_PATH=^M$
set SQLPATH=^M$
set NLS_DATE_FORMAT=YYYY-MM-DD HH24:MI:SS ^M$
~~~~~~~~~~~~~~
set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK^M$
set NLS_TIMESTAMP_FORMAT=YYYY-MM-DD HH24:MI:SS.FF^M$
set NLS_TIMESTAMP_TZ_FORMAT=YYYY-MM-DD HH24:MI:SS.FF TZH:TZM^M$
echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book^M$
--//下劃線哪行S後面有18個空格.

d:\tmp\study>nls
d:\tmp\study>rem @ echo off
d:\tmp\study>set ORACLE_PATH=
d:\tmp\study>set SQLPATH=
d:\tmp\study>set NLS_DATE_FORMAT=YYYY-MM-DD HH24:MI:SS
d:\tmp\study>set NLS_LANG=AMERICAN_AMERICA.ZHS16GBK
d:\tmp\study>set NLS_TIMESTAMP_FORMAT=YYYY-MM-DD HH24:MI:SS.FF
d:\tmp\study>set NLS_TIMESTAMP_TZ_FORMAT=YYYY-MM-DD HH24:MI:SS.FF TZH:TZM
d:\tmp\study>echo select sysdate,systimestamp,localtimestamp from dual ; | sqlplus -s -l system/bookbook@192.168.56.101:1521/book
SP2-0642: SQL*Plus internal error state 2021, context 1:1801:0
Unsafe to proceed
kgepop: no error frame to pop to for error 1801
kpedbg_dmp_stack<-kpedbgdmp<-kgerinv_internall<-kgerinv<-kgerin<-kgepop<-kgesecl0<-kolderr<-ldxsnf<-ldxsti<-ldxbegin<-ldxini<-kpuuini..0<-kpuinit0<-kpuenvcr<-OCIEnvCreate<-OCIEnvCreate<-afioci<-aficntini<-afidrv<-main<-?__scrt_common_main_seh@@YAHXZ<-0x00007FFCD9987034<-0x00007FFCDB2E26A1
kpedbg_dmp_stack<-kpedbgdmp<-kgepop<-kgesecl0<-kolderr<-ldxsnf<-ldxsti<-ldxbegin<-ldxini<-kpuuini..0<-kpuinit0<-kpuenvcr<-OCIEnvCreate<-OCIEnvCreate<-afioci<-aficntini<-afidrv<-main<-?__scrt_common_main_seh@@YAHXZ<-0x00007FFCD9987034<-0x00007FFCDB2E26A1

--//如果有17個空格,就不會報錯.可以簡單驗證:
SYS@192.168.56.101:1521/book> alter session set nls_date_format='YYYY:MM:DD HH24:MI:SS ';
ERROR:
ORA-01801: date format is too long for internal buffer

SYS@192.168.56.101:1521/book> alter session set nls_date_format='YYYY:MM:DD HH24:MI:SS ';
ession altered.
--//後面有17個空格.

SYSTEM@192.168.56.101:1521/book> select sysdate from dual ;
SYSDATE
------------------------------------
2024:08:14 16:34:15

--//不過這個問題如果那位在環境變數裡定義這樣的情況,問題就很難查了.
--//提醒一下:實際上sqlplus有提示:
SP2-0642: SQL*Plus internal error state 2021, context 1:1801:0
kgepop: no error frame to pop to for error 1801
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
--//裡面1801就是提示.

$ oerr ora 1801
01801, 00000, "date format is too long for internal buffer"
// *Cause:
// *Action:
--//在這樣的情況我使用toad程式直接退出,根本沒有任何提示.

9.總結:
--//寫這麼多,感覺自己把問題想的複雜了,總之在windows下定義oracle環境變數不要單雙引號就ok了.
--//windows下環境變數賦值相當於整個作為字串傳入變數,比如結尾的空格也作為變數的一部分.
--//linux下不行,因為字串裡面包含空格,必須使用單雙引號,並且不作為變數的一部分.
--//有機會測試linux下上面各種賦值的情況.

--//測試時走了彎路,沒有規避loing.sql的影響,導致被輸出結果給帶偏了,浪費大量的時間.

--//不過我還是無法理解使用兩個雙引號的情況,還有就是sqlplus的標題丟失問題.
--//關於標題問題只能稱為oracle的靈異事情,另外寫一篇blog分析.

相關文章