Secure File Transfer Protocol (SFTP) サーバーからデータをインポートするための接続を Anaplan Data Orchestrator で作成します。次に、その接続を使用してデータを抽出し、ソース データセットを作成します。

接続を作成する前に、次のものが必要です。

  • Amazon Web Services (AWS) か任意のクラウド サービス事業者でホスティングされている SFTP サーバー、又は オンプレミスの SFTP サーバー。
  • Secure Shell (SSH) 秘密鍵があり、バケットとオブジェクトに対して少なくとも読み取り権限を持つユーザー。
  • SFTP サーバーに接続されているバケットのサブセットへのフォルダー パス。

SFTP への接続の作成

接続を作成するには以下を実行します。

  1. 左上のナビゲーション メニューから [Data Orchestrator] を選択します。
  2. 左側のパネルから [Connections] を選択します。
  3. [Create connection] を選択します。
  4. [Create connection] ページで [SFTP] を選択し、[Next] を選択します。
    コネクターが見つからない場合は、[Find...] フィールドに検索ワードを入力します。
  5. [Connection details] ページで次の詳細を入力し、[Next] を選択します。
    • Name (名前):接続の名前を作成します。名前には英数字とアンダースコアを使用できます。
    • Description (説明):必要に応じて、接続に関する説明を入力します。
  6. [Connection credentials] ページで SFTP の認証情報を入力し、[Next] を選択します。
    • Host (ホスト):SFTP サーバーのホスト名を入力します (たとえば、「s-52d4b77da9example.server.transfer.us-east-1.amazonaws.com」)。
    • Port (ポート):SFTP ポートを入力します (たとえば、「22」)。
    • Username (ユーザー名):SFTP サーバーのユーザー名を入力します (たとえば、「sftp-user」)。
    • Private Key (秘密鍵):SFTP サーバーにリンクされている SSH 秘密鍵 (OpenSSH 形式) を入力します。「ssh-keygen -t rsa -b 4096 -f <keyfilename>」というコマンドでキー ペアを生成できます。このコマンドにより、公開鍵 (.pub) と秘密鍵が 1 つずつ作成されます。公開鍵は SFTP サーバーにリンクされ、秘密鍵は接続の作成に使用されます。
      以下に SSH 秘密鍵の例を示します。

-----BEGIN OPENSSH PRIVATE KEY-----
b3BlbnNzaC1rZXktdjEAAAAABG5vbmUAAAAEbm9uZQAAAAAAAAABAAABlwAAAAdzc2gtcn
...(Base64 形式の秘密鍵の内容) ...
... 複数の行 ...
-----END OPENSSH PRIVATE KEY-----

  1. 接続テストが完了したら、[Done] を選択します。

SFTP 接続からのデータの抽出

SFTP 接続からデータを抽出して、ソース データを Data Orchestrator に追加できます。抽出したデータから、ソース データセットを作成します。

データを抽出するには以下を実行します。

  1. 左上のナビゲーション メニューから [Data Orchestrator] を選択します。
  2. 左側のパネルから [Source data] を選択します。
  3. [Add data] → [From connection] を選択します。
  4. [Dataset details] ページで次の詳細を入力し、[Next] を選択します。
    • Connection (接続):作成した SFTP 接続を選択します。
    • Dataset name (データセット名):データセットの名前を入力します。
    • Description (説明):必要に応じて、データセットの説明を入力します。
    • Path name (パス名):ファイル パス パターンを指定します (デフォルトのパターン: /**/*.csv)。
    • Column Separator (列の区切り文字)次のオプションから区切り文字を選択します:[Tab]、[Comma]、[Semicolon]、[Other]。[Other] を選択した場合はカスタム区切り文字を指定します。
    • Text Delimiter (テキストの区切り文字):CSV 内のテキストを囲むために使用する文字を指定します (例: ")。
    • Header Row (ヘッダー列):ヘッダーが配置される行番号を指定します (例: 1)。
    • First Data Row (データの一行目):実際のデータが始まる行番号を指定します (例: 2)。
  5. [Choose an upload type] ページで次の詳細を入力し、[Next] を選択します。
    1. [Load type] を選択します。
      • Full replace (完全置換):データセット全体を新しいデータに置き換えます。
      • Append (追加):以前のレコードを削除または更新せずに、新しいファイル又は更新されたファイルのレコードを既存のデータセットに追加します。
      • Incremental (増分):新規または更新されたファイルからレコードを取得し、一致する主キーに基づいてデータセット内の既存のレコードを更新し、一致しない主キーを持つレコードを追加します。
    2. インポートする列を選択します。
      • 読み込みタイプとして [Incremental] を選択した場合、[Primary Key (PK)] は必須です。システムでは PK を使用して既存のレコードを識別および更新します。[Cursor Field] が自動的に選択され、パターンに一致するファイルの最終更新日が表示されます。これにより、新しいファイル又は更新されたファイルのみが同期に含まれるようになります。
      • 読み込みタイプとして [Append] を選択した場合、システムでは自動的に [Cursor Field] を選択します。したがって、設定する必要はありません。これにより、新しいデータをシームレスに追加し、同期を維持できます。
  6. 確認ダイアログで [Create] を選択します。