データ・ドメインのエクスポートおよびインポート

データ・ドメインをエクスポートすると、データ・ドメインの索引ファイルのスナップショットが取得され、バックアップに役立ちます。データ・ドメインをインポートすると、エクスポートされた索引に基づいて新しいデータ・ドメインを作成できます。

データ・ドメインをエクスポートすると、Endeca Serverは索引ファイルのスナップショットを取得し、共有ファイル・システム上のオフライン・ディレクトリに保存します。データ・ドメインの索引をエクスポートしている間、データ・ドメインの実行は継続されます。同じデータ・ドメインを再度エクスポートする必要がある場合は、エクスポートされる索引に別の名前を使用します。

注意: スナップショットは、索引ファイルのコピーのみを表し、データ・ドメインのその他の特性は取得しません。つまり、後でスナップショットからデータ・ドメインをインポートする場合、Endeca Serverはデータ・ドメイン・プロファイルの1つを使用して同じ索引に基づいて新しいデータ・ドメインを作成します。

データ・ドメインをインポートする場合、以前に取得した索引ファイルのスナップショットが指定された索引ラベルからコピーされ、指定されたデータ・ドメイン・プロファイルを使用して新しいデータ・ドメインが作成されます。オプションで、新しいデータ・ドメインを有効にするかどうかを指定できます。新しいデータ・ドメインは、スナップショットからコピーされた索引ファイルを使用します。

データ・ドメインをエクスポートおよびインポートするには、次の手順を実行します。

  1. コマンドライン・ウィンドウを使用して(たとえば、Windowsのコマンド・プロンプトを開いて)、endeca-cmdディレクトリに移動します。
  2. 次の例に示すオプションを使用します。
    オプション 説明
    エクスポート: 
    endeca-cmd export-dd my_dd 
--offline-name my_dd_offline
    		 コマンドのこの例では、データ・ドメインmy_ddの索引をmy_dd_offlineという名前の索引ファイルにエクスポートします(独自の名前を指定できます)。エクスポートされた索引はオフライン・ディレクトリに格納されます。オプション --offline-nameに指定する名前は一意である必要がありますが、省略することもできます。名前を省略した場合、name_MMMMM-dd-yyyy-hh-mmの形式で元のデータ・ドメイン名に日付を追加することで、名前が自動的に割り当てられます。このリクエストに対する正常なレスポンスは、エクスポートされる索引に使用される結果名を返します。
    重要: --offline-nameの値は、後でこの索引をインポートする際に必要になるため、記録を残してください。
    インポート: 
    endeca-cmd 
import-dd new_dd 
--offline-name my_dd_offline
--dd-profile-name TestDDProfile 
--is-enabled false
    		 コマンドのこの例では、索引my_dd_offlineを新しいデータ・ドメインnew_ddにインポートします。これはTestDDProfileデータ・ドメイン・プロファイルで作成され、作成後に有効化されません。
    注意: インポートでは、索引が現在エクスポートされているデータ・ドメインが作成済であることを前提としています。また、エクスポート時に使用した--offline-name値を追跡しているか、または自動的に割り当てられた名前を把握していることも前提としています。

    endeca-cmdを使用しない場合、次の略例のように、管理WebサービスのリクエストでimportDataDomainおよびexportDataDomain操作を使用できます。

    データ・ドメインmy_ddの索引をエクスポートするエクスポート操作の例を次に示します。 
    <ns1:exportDataDomain xmlns:ns1="http://www.endeca.com/endeca-server/manage/2/0">
    <ns1:name>my_dd</ns1:name>
    <ns1:nameOfOfflineDataDomain>my_offline_index</ns1:nameOfOfflineDataDomain>
</ns1:exportDataDomain>
    次のレスポンスが生成されます。 
    <ns3:exportDataDomainResponse
      xmlns:ns2="http://www.endeca.com/endeca-server/types/2/0"
      xmlns:ns3="http://www.endeca.com/endeca-server/manage/2/0">
   <ns3:exportName>my_offline_index</ns3:exportName>
</ns3:exportDataDomainResponse>

    my_offline_indexは、エクスポートされた索引ファイルの名前です。

    デフォルトのデータ・ドメイン・プロファイルに基づいて新しいデータ・ドメインnew_ddを作成するインポート操作の例を次に示します。このデータ・ドメインは作成後に有効になります。 
    <ns1:importDataDomain xmlns:ns1="http://www.endeca.com/endeca-server/manage/2/0">
    <ns1:name>new_dd</ns1:name>
    <ns1:nameOfOfflineDataDomain>my_offline_index</ns1:nameOfOfflineDataDomain>
    <ns1:ddProfileName>default</ns1:ddProfileName>
    <ns1:enabled>true</ns1:enabled>
</ns1:importDataDomain>

    操作が正常に実行されると、空のimportDataDomainResponseが返されます。