Oracle DB Tips

ORA-01481: 数値書式モデルが無効です

01.ORA-01481エラーとはどのようなエラーか？

TO_CHAR(数値)関数または TO_NUMBER関数などで任意の書式モデルを指定して変換を行った際に、書式モデルに誤った数値書式を指定しているため発生するエラーです。

02.ORA-01481エラーのエラー出力例

例：文字列 ‘-200’ を負の符号付き数値(3桁)に変換しようとして以下のSQL文を発行した場合

SQL> SELECT TO_NUMBER('-200','-999') FROM dual;
SELECT TO_NUMBER('-200','-999') FROM dual
*
行1でエラーが発生しました。:
ORA-01481: 数値書式モデルが無効です

03.ORA-01481の一般的な発生要因と対処

ORA-01481は一般的に以下の要因で発生します。

TO_CHAR(数値) 関数または TO_NUMBER 関数で指定する数値書式が不正。

上記のエラー出力例の場合、TO_NUMBER 関数の第二引数 ‘-999’ は正しい数値書式の指定ではないため、ORA-01481が発生しています。適切な数値書式を指定することで、意図した書式モデルへの変換を行います。
上記例の場合、数値3桁かつ先頭に符号を付与する書式は ‘S999’ であるので、正しくは以下のSQL文になります。

SQL> SELECT TO_NUMBER('-200','S999') FROM dual;
TO_NUMBER('-200','S999')
------------------------
-200

数値書式モデルを指定することができる変換関数としては、TO_CHAR, TO_NUMBER 以外に、TO_BINARY_DOUBLE, TO_BINARY_FLOAT があります。

ORA-01481に関するFAQ

数値書式にはどのような種類がありますか？

数値書式には様々な書式が豊富に用意されています。例として以下のような書式に変換することができます。

数値をカンマ区切りやピリオド区切りで表記
科学的表記法で表記（1.00E+001 など）
通貨記号（ドル、ユーロ、ローカル通貨、ISO通貨など）の付与
先頭0埋めで表記(*1)

数値書式の種類と指定方法については、使用している Database バージョンの『SQL言語リファレンス』マニュアル内の「書式モデル」に詳細な記載がありますのでそちらを参照ください。
(*1) TO_CHAR 関数にて数値から文字列に変換する場合

04.キーワード

ORA-1481 ORA-01481 数値書式モデル無効 TO_CHAR TO_NUMBER 変換フォーマット

この記事の監修者

舛井智行 (ますいともゆき)

営業本部　企画&マーケティング部　次長

《資格》

Oracle Master Gold、Oracle RAC Expert、Linux Expert、LPIC Level1、Dbvisit Standby Certified Associate、基本情報技術者

《略歴》

2004年コーソル入社。2019年まで一貫してOracle Databaseの設計・構築・運用のサービス提供に従事。リモートDBAやリモート監視のサービス化、働き方改革プロジェクトで人事制度改革を手掛ける。2019年からライセンス販売強化のため企画&マーケティング部に異動。DbvisitやToad、DPAの取扱開始、販売促進活動を推し進め、ライセンス販売事業の売上拡大に注力中。

《主な著書》

オラクルマスター教科書 Gold DBA Oracle Database AdministrationⅡ
オラクルマスター教科書 Silver DBA Oracle Database Administration I
オラクルマスター教科書 Silver SQL Oracle Database SQL
Oracleの基本～データベース入門から設計/運用の初歩まで
プロとしてのOracle入門
Oracle Database 10g Oracle Enterprise Manager 逆引きクイックリファレンス

《担当者様からの一言》

コーソルはOracle Databaseの技術力において日本有数の知見を有すると自負しています。Oracle Masterの最高峰資格である『Oracle Master Platinum』の取得者数も日本No.1です。Oracle Databaseのことはもちろん、それ以外のDBについてもリモートDBAサービスを始めとした様々なサービス、製品を駆使してお客様のお困りごとを解消いたします。お困りごとがあればコーソルまでご相談ください。

峯岸隆一 (みねぎしりゅういち)

インフラソリューション部市ヶ谷クラウドサービスチームシニアエキスパート

《資格》

Oracle Master Gold、ORACLE MASTER Platinum、Oracle RAC Expert、
Oracle Database Cloud Service Oracle Infrastructure as a Service Cloud 2017 Implementation Essentials、
Oracle Cloud Infrastructure 2018 Architect Associate、
Oracle Cloud Infrastructure 2019 Architect Professional、
AWS Certified Solutions Architect – Associate、OSS-DB Silver、
MySQL 5.6 Database Administrator、基本情報技術者、テクニカルエンジニア(データベース)

《略歴》

2006年コーソル入社。2021年までOracle Databaseを中心にMySQLやGoldenGateなど、多岐にわたる製品のサポート業務に従事。2021年から企画&マーケティング部に異動し、Nutanix NDBサービス化、Qlik Replicateサービス化、AWS、OCIなど様々な製品のサービス化、クラウド環境上の製品検証、ブログ執筆を手掛ける。2023年からOCI技術に磨きをかけるべくOCI基盤の設計・構築業務を遂行中。

《主な著書》

オラクルマスター教科書 Gold DBA Oracle Database AdministrationⅡ
オラクルマスター教科書 Silver DBA Oracle Database Administration I
オラクルマスター教科書 Silver SQL Oracle Database SQL 　Oracleの基本～データベース入門から設計/運用の初歩まで

《担当者様からの一言》

コーソルはOracle Database製品および周辺製品において特化した技術力を有している会社です。また、育成にも力を入れており、新卒などOracle Databaseの知識がないエンジニアでも数年でOracle Master Platinumを取得するほどのエンジニアに育て上げることに成功しています。クラウド分野(AWS、Oracle Cloud)にも積極的に進出しておりますので、Oracle Databaseに関するサービスをご要望であればプラットフォーム問わず対応できるコーソルにご連絡下さい。