[データソース] フィールド

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む13読むのに数分
  • [タイプ] フィールドの値に応じて、共通フィールドに加えて他のフィールドが [データソース] フォームに表示されます。

    共通データソースフィールド

    これらのフィールドはすべてのデータソースに共通です。

    フィールド 説明
    名前 このデータソースの一意の名前。
    インポートセットテーブルラベル 使用するインポートセットステージングテーブルのラベル。
    インポートセットテーブル名 Now Platform は、入力したラベルを使用して一意のテーブル名を作成します。これにより、既存のテーブルとの名前空間の衝突が防止されます。
    タイプ インポートするデータのタイプ:
    • リモートファイルから
    • JDBC データベースから
    • LDAP を使用する
    • OIDC を使用する
    • REST を使用して 統合ハブ からデータをインポートする
    • データストリームアクションから 統合ハブ を介して
    • カスタムスクリプトを使用する
    バッチインポートを使用 選択した場合、[データのロード] または [20 件のレコードのテストロード] をクリックしたときにデータのロードをバッチ処理する必要があることを指定します。
    バッチサイズ バッチの大きさを指定します。[バッチインポートを使用] フィールドが選択されている場合にのみ表示されます。
    glide.import_set_load_usebatch および glide.import_set_load_batch_size プロパティは、これらのフィールドに影響します。プロパティとフィールドの優先順位は次のとおりです。プロパティが設定されている場合は、プロパティ値を使用します。そうでない場合は、フィールド値を使用します。どちらのプロパティも設定されていない場合は、デフォルトのバッチサイズである 1000 を使用します。
    • たとえば、glide.import_set_load_usebatch = trueglide.import_set_load_batch_size = 200 の場合、フィールド値に関係なくバッチサイズとして 200 を使用します。
    • たとえば、 glide.import_set_load_usebatch = trueglide.import_set_load_batch_size プロパティが設定されていない場合は、デフォルトのバッチサイズである 1000 を使用します。
    • たとえば、 glide.import_set_load_usebatch プロパティが設定されておらず、[バッチインポートを使用] フィールド = true の場合、[バッチサイズ] フィールド値 (または [バッチサイズ] フィールド値が設定されていない場合はデフォルトの 1000) を使用します。
    • たとえば、glide.import_set_load_usebatch プロパティ= false で、[バッチインポートを使用] フィールド = true の場合、プロパティが false に設定されているため、バッチインポートは使用しません。
    アプリケーション このレコードのアプリケーションスコープ。

    ファイルタイプのデータソースフィールド

    これらの追加フィールドは、[タイプ] フィールドの値が [ファイル] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    フォーマット 「Strict Open XML ドキュメント」として保存されていない限り、デフォルトの XML ベースのファイル形式 (.xlsx) のみがサポートされます。
    Zip 圧縮 インポートファイルが圧縮されている場合に選択されます。
    ファイル取得手法 このファイルの取得手法。
    ファイルパス インポートするファイルへのパス。
    ${system.property.name} 形式を使用して、このフィールドにシステムプロパティ値を含めることができます。接続が確立されると、変数は指定されたプロパティの値に置き換えられます。
    注:
    HTTP または HTTPS を使用して取得されたファイルの場合、システムプロパティ展開を使用するには glide.ds.file.http.variable_replacement プロパティが true である必要があります。

    たとえば、ファイルパス/countries.csv?key=${datasource.apikey} を指定できます。接続が確立されると、datasource.apikey システムプロパティの値が key パラメーターの値として渡されます。

    注:
    HTTP および HTTPS プロトコルの場合、ファイルパスは自動的に URL エンコードされます。これらのプロトコルのいずれかを使用する場合は、URL エンコードされたファイルパスを指定しないでください。
    CSV 区切り文字 CSV ファイルの区切り文字。
    解析スクリプト 単一行の入力を解析するために使用されるスクリプト。スクリプトを入力すると、スクリプトのオートコンプリートによって利用可能な選択肢が表示されます。詳細については、「ファイルタイプのデータソース」を参照してください。
    シート番号 データをロードするための Excel シート番号。
    ヘッダー行 列ラベルをロードするための Excel 行番号。
    各行のパス インポートセットテーブルで行となる JSON オブジェクトの選択に使用するパス式。JSON オブジェクトのパスは // にする必要があります。
    配列を破棄 JSON アレイを値として破棄する場合に選択します。JSON アレイを値としてシリアル化する場合に選択解除します。
    拡張ノード子 XML ノードまたは JSON オブジェクトの子要素を追加の列に変換する必要がある場合に選択します。親列の値を XML または JSON フラグメントにする必要がある場合に選択解除します。JSON の場合、このオプションを選択すると、オブジェクトのみが展開され、アレイは展開されないことに注意してください。ネストされたアレイのサポートについては、「JSON ファイルのインポート例」を参照してください。
    単一列のデータ 単一列にデータを格納する場合に選択されます。
    各行の XPath インポートテーブルの行となるノードを選択する XPath 式。選択したノードの子が行の列になります。
    SCP 認証手法 ユーザー名とパスワードを使用して認証するか、または公開キーを使用して認証するかを選択します。
    注:
    データソースに対して公開キーと秘密キーのペアを使用して認証することはできません。代わりにユーザー名とパスワードでの認証を使用します。
    サーバー テーブルのインポート元のサーバーの名前。
    ポート 指定されたサーバーへの接続に使用するポート。このフィールドは、ファイル取得方法として HTTP または HTTPS を選択した場合に表示されます。
    ユーザー名 JDBC サーバーでの認証用のユーザー名。
    パスワード JDBC サーバーでの認証用のパスワード。
    秘密キーファイル 従来の SCP 公開/秘密キーファイルを使用する場合のキーファイル。
    注:
    • データソースに対して公開キーと秘密キーのペアを使用して認証することはできません。代わりにユーザー名とパスワードでの認証を使用します。
    • この従来のオプションは使用しないでください。使用は可能ですが、サポートされていません。
    システムキーストア FTPS サーバーからの証明書を、保存されているすべての証明書と照合して検証する場合に選択します。この証明書は、インスタンスでサポートされている任意のタイプにできます。選択しない場合、インスタンスは Java デフォルト証明書を使用して FTPS サーバーを検証します。このフィールドは、[ファイル取得方法] の値が FTPSのデータソースでのみ使用できます。Auth TLS、Auth SSL、Implicit SSL、Implicit TLS などの、すべての FTPS ファイル取得方法がサポートされています。

    JDBC タイプのデータソースフィールド

    これらの追加フィールドは、[タイプ] フィールドの値が [JDBC] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    MID Server を使用 このデータソースへの接続に使用する MID Server。
    形式 次のいずれか形式:MySQL、Oracle、または SQLServer
    インスタンス名 SQL Server との動的ポート接続をサポートするために使用されます。接続性を確保するには、再起動するたびに新しいポート番号を動的に受け取る SQL Server のインスタンス名を指定します。このフィールドは、SQLServer がデータソース形式として選択されている場合にのみ表示されます。
    データベース名 データベースインスタンスの名前。
    データベースポート データベースのポート番号。SQL Server で動的ポート接続を使用する場合は、このフィールドを空のままにしておきます。
    統合認証を使用 SQL Server 認証用に Windows MID Server サービス用に構成されたユーザーの ID を、JDBC 接続で使用できるようにする場合に選択します。その他の詳細については、「JDBC タイプのデータソース」を参照してください。
    ユーザー名 JDBC サーバーでの認証用のユーザー名。
    パスワード JDBC サーバーでの認証用のパスワード。
    サーバー テーブルのインポート元のサーバーの名前。
    クエリ 実行するクエリのタイプ:[テーブルからのすべての行] または [特定の SQL]。SQL ステートメントの実行を選択した場合は、[SQL ステートメント] フィールドが表示されます。
    クエリタイムアウト JDBC ドライバーがクエリ (SELECT) の完了を待機する秒数。ゼロ (0) はタイムアウトなしを意味します。タイムアウトになると、統合認証は、JDBC の結果がアクセス不可能であるとみなし、エラー状態にします。
    接続タイムアウト MID Server 接続キャッシュプールが接続をクローズしてプールから削除するまでの秒数。ゼロ (0) はタイムアウトなしを意味します。
    テーブル名 データのエクスポート元のテーブルの名前。
    SQL ステートメント データベースから目的のデータを抽出するための SQL ステートメント。
    前回実行日時を使用 インポートの実行中にデータベースから取得するデータの量を制御します。選択を解除すると、指定したテーブルのすべての行が毎回インポートされます。これが 1 回限りのインポートである場合、またはターゲットテーブル内のすべてのデータが新規である場合は、この設定を使用することができます。選択すると、2 つの追加フィールドが表示され、インポートされるデータをデルタ値のみに制限する [日付と時刻] 値を選択できます。
    前回実行日時 このフィールドの日時値は、以下で選択したデータベースフィールドから自動的に入力され、前回の実行からの最新の値を表します。この値は、取得するレコード数を、データソースの前回のランタイム以降に変更されたレコード数に制限する動的フィルターとして機能します。
    前回実行データベースフィールド 次の実行でフィルターとして使用されるソーステーブルのフィールド名。この値は、ターゲットデータベースタイプによっては、大文字と小文字を区別する必要があります。
    追加のデータベースパラメーター このデータソースに対して生成された URL の最後に追加するオプションのパラメーター。セミコロンで区切られたパラメーターのリスト。このフィールドを表示するには、フォームの構成が必要になる場合があります。

    LDAP タイプのデータソースフィールド

    この追加フィールドは、[タイプ] フィールドの値が [LDAP] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    LDAP ターゲット LDAP OU 定義のリストから選択されたターゲット。

    OIDC タイプのデータソースフィールド

    この追加フィールドは、[タイプ] フィールドの値が [OIDC] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    形式 デフォルトは [-- なし --] であり、変更できません。

    REST (統合ハブ) タイプのデータソースフィールド

    これらの追加フィールドは、[タイプ] フィールドの値が [REST (IntegrationHub)] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    フォーマット 次のいずれかの形式:カスタム (スクリプトによる解析)、JSON、または XML。
    要求アクション データを取得するために呼び出されるデータソース要求アクション。公開された要求アクションのみを選択できます。

    下のダイアログボックスのリンクをクリックして、統合ハブ で新しいデータソース要求アクションを作成/構成します。要求アクションが 統合ハブで公開された後、それをデータソースレコードの要求アクションとして選択できます。詳細については、「アクションプロパティを定義する」を参照してください。

    ページネーションのサポート 要求アクションのページネーションを有効にする場合に選択します。ページネーションを使用すると、すべてのレコードを一度に処理するのではなく、一度に指定した数のレコードを処理することで、処理のオーバーヘッドを削減できます。
    制限 ページあたりの最大レコード数。たとえば、一度に 50 のレコードを処理するには、[制限] に 50 を入力します。
    オフセット ページネーションに使用された初期オフセット。オフセットは開始レコード番号です。たとえば、一度に 50 のレコードを処理するには、最初のレコードから開始して、[制限] に 50、[オフセット] に 0 を入力します。
    解析スクリプト 単一行の入力を解析するために使用されるスクリプト。スクリプトを入力すると、スクリプトのオートコンプリートによって利用可能な選択肢が表示されます。詳細については、「ファイルタイプのデータソース」を参照してください。
    各行のパス インポートセットテーブルで行となる JSON オブジェクトの選択に使用するパス式。JSON オブジェクトのパスは // にする必要があります。
    配列を破棄 JSON アレイを値として破棄する場合に選択します。JSON アレイを値としてシリアル化する場合に選択解除します。
    拡張ノード子 XML ノードまたは JSON オブジェクトの子要素を追加の列に変換する必要がある場合に選択します。親列の値を XML または JSON フラグメントにする必要がある場合に選択解除します。JSON の場合、このオプションを選択すると、オブジェクトのみが展開され、アレイは展開されないことに注意してください。ネストされたアレイのサポートについては、「JSON ファイルのインポート例」を参照してください。
    単一列のデータ 単一列にデータを格納する場合に選択されます。
    各行の XPath インポートテーブルの行となるノードを選択する XPath 式。選択したノードの子が行の列になります。

    データストリーム (統合ハブ) タイプのデータソースフィールド

    これらの追加フィールドは、[タイプ] フィールドの値が [データストリーム (IntegrationHub)] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    タイプ データストリーム (統合ハブ) タイプのデータソース。
    データストリームアクション
    • [データストリームアクションを選択 (Select Data Stream action)]統合ハブ から既存の公開済みデータストリームアクションを使用する場合に選択します。
    • [公開されたデータストリームアクションを選択、または新しいデータストリームアクションを作成 (Select published Data Stream action or create new Data Stream action)] 次のいずれかの理由がある場合に選択します。
      • 公開されたデータストリームアクションを選択する場合は、このボタンをクリックして、統合ハブ でデータストリームアクションを開きます。
      • データストリームアクションを選択しない場合は、このボタンをクリックして、統合ハブ で新しいデータストリームアクションを作成して公開します。
    注:
    データストリームアクションには本番環境用のサブスクリプションが必要です。
    接続

    データストリームアクションの接続エイリアスを指定します。デフォルトの親エイリアスを使用するか、その子のエイリアスを選択できます。利用可能な子エイリアスがメニューに一覧表示されます。

    このフィールドは、データストリームアクションが接続エイリアスを使用するように設定されている場合にのみ使用できます。詳細については、「接続および資格情報エイリアスの作成」を参照してください。

    単一列のデータ 単一列にデータを格納する場合に選択されます。
    データストリームアクションの入力 データストリームアクションで定義された入力に基づいて、追加のフィールドが表示される場合があります。

    カスタム (スクリプトでロード) タイプのデータソースフィールド

    この追加フィールドは、[タイプ] フィールドの値が [カスタム (スクリプトでロード)] の場合に [データソース] フォームに表示されます。

    フィールド 説明
    データローダー データのロードに使用されるスクリプト。詳細については、「カスタム (スクリプトでロード) タイプのデータソース」を参照してください。