データストアの URL

データベースでホストされているデータ ファイルおよびフォルダーを操作できるユーティリティやライブラリ ルーチンがいくつかあります。データストア内のこれらのファイルおよびフォルダーを参照するには、次に示すように、特定の URL を使用する必要があります。

sql://<server-name>/<datastore-name>/<file-name>[?<file-attributes>]     *> file url
sql://<server-name>/<datastore-name>?type=folder;[folder=/<folder-name>] *> folder url

詳細は次のとおりです。

server-name
データベース構成ファイル内のサーバー エントリの名前。サーバー名として「(local)」または「localhost」を指定すると、実行時に、そのサーバーを使用するプロセスを実行しているマシンの名前に置き換えられます。
datastore-name
データストアの名前。
file-name
データ ファイルの名前。
file-attributes
データ ファイルの属性 (そのタイプやデータストア内の場所など)。
属性 説明
type
  • blob
  • folder
  • lseq
  • rrds
  • seq
  • type=blob
  • type=folder
  • type=lseq
  • type=rrds
  • type=seq
ファイル タイプ。これは、ファイル ヘッダーのないファイルをデータベースにディプロイする場合にのみ指定する必要があります。
reclen <min[,max]>
  • type=lseq;reclen=0,80
  • type=seq;reclen=0,80
  • type=rrds;reclen=80
  • type=seq;reclen=80
可変長の順編成ファイルの最小レコード長および最大レコード長、あるいは固定長の順編成ファイルまたは RRDS ファイルのレコード長。これは、ファイル ヘッダーのないファイルをデータベースにディプロイする場合にのみ指定する必要があります。
recterm
  • windows
  • linux
  • unix
  • recterm=windows
  • recterm=linux
  • recterm=unix
ファイルで使用されているレコード終了記号のタイプ。主に RRDS ファイルに使用され、現在ディプロイされているプラットフォームとは異なるプラットフォームで作成されたファイルにのみ必要です。
folder <folder-name>
  • folder=/MyFolder
  • folder=/MyFolder/SubFolder
フォルダー名。フォルダー名を明示的に指定しない場合は、ルート フォルダーが想定されます (つまり、folder=/)。
注: コマンド ラインで dbfhdeploy.exe -urlhelp を実行して、構文ヘルプを表示することもできます。

  • 次の例では、swt-bto ホストの SQL EXPRESS データベース インスタンスに格納されている JCLTEST データストアに保持されているファイル (my.dat) を参照します。
    sql://swt-bto/SQLEXPRESS/JCLTEST/my.dat
  • 次の例では、JCLTEST データストアの MyData フォルダーに保持されている別のファイル (another.dat) を参照します。
    sql://swt-bto/SQLEXPRESS/JCLTEST/another.dat?folder=/MyData
  • 次の例では、ローカル マシンの SEQDATA データストアの MySeqData フォルダーに保持されている順編成ファイル (newseq.dat) を参照します。
    sql://localhost/SEQDATA/newseq.dat?folder=/MySeqData;type=seq;reclen=0,80