文字列 (最大 128 バイト)

空の文字列

PUBLIC グループのみに設定できます。すぐに有効になります。DBA 権限が必要です。

データベースファイルのヘッダーページ内の情報を保存しておき、アプリケーションから直接ファイルを読み込んで情報を抽出できます。このページはシステム DB 領域ファイルのヘッダーに保存されます。OEM 文字列に対して 128 バイトを超える値を指定すると、エラーが返されます。

スキーマバージョン、アプリケーション名、アプリケーションのバージョンなどの情報は、保存しておくと役に立つことがあります。また、アプリケーションがデータベースファイルを使用する前に検証のために読み込む文字列を保存することによって、アプリケーションはデータベースを起動しなくても OEM 文字列によってデータベースファイルがそのアプリケーションに関連付けられているかどうかを確認できます。つまり、アプリケーションを設計するときに、OEM 文字列を使用してデータベースファイルがそのアプリケーション用であることを検証するプロセスを組み込むことができます。さらに、ユーザーに表示するメタデータを抽出することもできます。

oem_string をシステム DB 領域ファイルのヘッダー内に設定するには、次の文を実行します。

SET OPTION PUBLIC.oem_string=user-specified-string;

user-specified-string の値は、ISYSOPTION システムテーブルとシステム DB 領域ファイルのヘッダーの両方に保存されます。この文字列が SET OPTION 文に渡されるときには変換が行われないため、文字列を必要な文字セットで定義してから SET OPTION 文に指定する必要があります。文字列を必要な文字セットに変換するには、CSCONVERT 関数を使用します。

oem_string の値を問い合わせるには、以下の方法があります。

 ♦ アプリケーションからの oem_string オプションの値の問い合わせ

SQL Anywhere には 2 つのサンプルプログラムが付属しており、oem_string ディレクトリに保存されています。

Windows では、サーバーがこのデータベースファイルをロードした場合、アプリケーションからこのファイルを直接読み込むことはできません。データベースサーバーは、このファイルに排他ロックを設定します。これに対し、サポートされる UNIX プラットフォームでは、読み込みパーミッションのあるアプリケーションであれば、このファイルをいつでも直接読み込むことができます。ただし、OEM 文字列に対する変更は、直ちにファイルに反映されないことがあります。チェックポイントを発行すると、データベースサーバーがページ 0 をディスクにフラッシュするため、現在の OEM 文字列値がファイルに反映されます。

OEM 文字列を変更してから次のチェックポイントまでの間にデータベースサーバーで障害が発生すると、ファイルのヘッダーに新しい OEM 文字列値が反映されないことがあります。新しい OEM 文字列値は、データベースのリカバリが完了した後で正しく設定されます。

• CSCONVERT 関数 [文字列]
• oem_string 接続プロパティ

次の例は、データベースファイルに関する情報を示す OEM 文字列を暗号化し、データベースヘッダーファイルに保存します。

BEGIN 
  DECLARE @v VARCHAR(100); 
  SET @v = BASE64_ENCODE( ENCRYPT( 'database version 10', 'abc' ) ); 
  EXECUTE IMMEDIATE 'SET OPTION PUBLIC.oem_string = ''' || @v || ''''; 
END;

OEM 文字列の値を取得するには、次の文を実行します。

SELECT DECRYPT(
   BASE64_DECODE( 
      CONNECTION_PROPERTY( 'oem_string' ) ),'abc' )