データデザイナーでAmazon S3からのデータを使用
重要 - 画像/情報は四半期ごとのリリースで更新されます!
四半期ごとのリリースにて、最新の機能・情報を反映し、画像を含めた情報は更新されます。
概要
この記事では、管理者が任意のS3バケット (Gainsightマネージドバケットまたはカスタムバケット) のcsv/tsvファイルからデータを取得して、データデザイナーでデータセットを作成する方法に関するガイドラインを提供します。
ビジネスユースケース: 自社組織のITインフラストラクチャが、Amazon S3をデータソースとして使用してカスタマーサクセス データを保存し、そのデータを使ってデータデザイナーでデータセットを構築する場合。
前提条件
- コネクタ 2.0ページでS3接続を作成して、S3バケットをGainsight に接続します。この構成の詳細については、「Gainsight S3コネクター」記事を参照してください。
- データデザイナーでデータセットを作成する前に、必要なS3バケットでソースcsv/tsvファイルが利用できることを確認してください。
S3データセットを作成
S3データセットを作成するには:
- [データタイプ] ドロップダウンリストから [Amazon S3] を選択します。選択したAmazon S3ソースの下に、全てのバケット (Gainsightマネージド バケットとカスタムバケット) が表示されます。
- Gainsight管理バケットからcsv/tsvファイルを取得する場合は、Gainsight管理バケットです。Gainsightマネージドバケットにデータを取り込む方法については、CSV/TSV ファイルを S3 バケットにアップロードする記事を参照してください。
- S3カスタムバケットからcsv/tsvファイルを取得する場合は、S3カスタムバケットです。
注: 前提条件に示されているように、コネクタ 2.0ページでS3接続を確立している場合は、ここにS3バケットが表示されます。
- キャンバス画面で使用可能なバケットの一覧から、必要なバケットをドラッグ アンドドロップします。次のページに移動し、[ファイルまたはフォルダーの選択]とその[プロパティ]タブが表示されます。
ファイルまたはフォルダの選択
[インポートするファイルまたはフォルダー]タブで、選択したS3バケットで使用可能なオブジェクトの一覧を確認することができます。必要に応じて、フォルダ全体または単一のファイルを選択することができます。
ファイルを選択
S3ファイルを選択するには:
- インポートするオブジェクト名をクリックすると、[ファイルの選択]ページに移動します。
- 必要なファイルを選択し、 続けるをクリックします。以下のプロパティを選択することができる[プロパティ]ページに移動します。
- 日付パターンを使用:ファイルパスで日付パターンを使用するためには、これを選択します。日付パターンを使用チェックボックスを選択すると、以下のオプションが表示されます:
- サンプルファイル名:サンプルファイル名を表示します。
- 日付パターンを尊重:ファイル名で選択された日付パターンを尊重するには、これを選択します。
- 日付パターンを選択または入力: ドロップダウンリストから必要な日付パターンを検索または選択することも可能です。必要に応じてカスタム日付パターンを入力することも可能です。
- データの取得:スケジュールを実行する前にデータを取得する日数を選択することができます。
- ファイル区切り:このオプションは、類似したファイル名を持つ複数のファイルからS3データセットにデータを取り込む場合に使用することができます。必要に応じて、カンマ、パイプ、セミコロン、スペース、またはタブを使用することができます。
- テキスト修飾子:これはデータのインポート中に引用で指定された値を (特殊文字とともに) インポートするために使われます。必要に応じて、二重引用符または単一引用符を選択することができます。
- エスケープ文字:値に特殊文字を含めるために使われ、値の特殊文字の前に配置されます。必要に応じて、バックスラッシュ、二重引用符または単一引用符を選択することができます。
- 圧縮タイプ:圧縮形式を選択します。必要に応じて、なし、gzip、または bzipを選択することができます。
- 文字エンコーディング: 必要な文字エンコーディングを選択します。必要に応じて、UTF-8、16、16BE、ASCII、ISO-8859-1,5589-2,5589-3を選択することができます。
ただし、Gainsightでは、ファイルのプロパティを次のように設定することを推奨します:
- ソースファイルは暗号化されていますか: S3バケットのcsvファイルが暗号化されている場合は、こちらを選択します。[ソース ファイルは暗号化されていますか]チェックボックスを選択すると、[使用可能なキー]オプションが有効になり、正しいPGPキーを選択してcsv/tsvファイルの暗号を解除することができます。
- アーカイブファイル:使用後にS3ファイルをアーカイブするためには、[アーカイブファイル]チェックボックスを選択します。アーカイブフォルダーのパスを指定する必要があります。指定されたパスに新しいフォルダーが作成されます。
デフォルトでは、アーカイブフォルダーは、ソースファイルと同じレベルに作成されます。例えば、ソースCSVファイルがS3バケットのすぐ近くにあり、どのフォルダーにもネストされていない場合、アーカイブされたフォルダーはS3バケットのすぐ近くのレベルで作成されます。ソースCSVファイルがフォルダーにネストされている場合、アーカイブフォルダーもネストされたレベルで作成されることになります。必要に応じて、デフォルトパスを変更することができます。 - [保存してインポート]をクリックします。[フィールドを選択]タブに移動されます。
フィールドを選択
ファイルを保存してインポートすると、[フィールドを選択]タブに移動します。ここでは、選択したフォルダーで使用可能なS3ファイルの全てのフィールドを確認することができます。
フィールドを選択するには:
- データセットに追加したいフィールドを選択し、次に[選択]をクリックします。
- これで、データセットの編集、フィールドの追加/削除、ファイルプロパティの設定ができるようになりました。詳細についてはデータセットの編集セクションを参照してください。
- [保存] をクリックします。
データセットの編集
データセットを編集するには:
[ペンシル]アイコン (または)[オプション]をクリックし、次に[編集]をクリックしてデータセットを編集します。次のページに移動し、[フフィールド]と[ファイルプロパティ]タブが表示されます。
フィールド
フィールドタブから次のオプションを閲覧することができます:
- データセット名を入力:データセット名を編集する場合は、[データセット名を入力]テキストボックスにデータセット名を入力します。
- フィールドを検索:[検索フィールド]テキストボックスに、検索したいフィールド名を入力します。検索オペレーションは、S3バケットで利用可能なフィールドに作用します。
- フィールドの追加:[フィールドの追加]をクリックして、データセットに追加する必須フィールドを選択し、次に[選択]をクリックします。フィールドの選択を解除して、データセットからフィールドを削除することも可能です。
- +カスタムフィールドを追加:S3ファイルでは使えない新しいフィールドをデータセットに作成する場合は、[+カスタムフィールドを追加]をクリックします。新しいフィールドを作成するには:
- 「フィールド名」を入力。
- データタイプを選択します。
- 表示名を入力します。
- [保存] をクリックします。警告ダイアログが表示されます。
- [保存] をクリックして、新しいフィールドを保存します。
- データタイプ: フィールドデータタイプを選択および変更することができます。
- 表示名:デフォルトでは、[表示名]テキストに[フィールド名]が表示されますが、必要に応じて変更することができます。表示名はデータセット/レポートに表示されます。
- 設定: このオプションは、日付、数値、および日時データタイプでのみ使用できます。[設定]アイコンをクリックして、小数点以下の桁数、日付と時刻のフォーマットを入力/設定します。
- 日付データタイプフィールドの場合、日付フォーマットを設定することができます。
- 数値データタイプフィールドの場合、小数点以下の桁数を設定することができます。
- 日時データタイプフィールドでは、日時フォーマットとタイムゾーンを設定することができます。
- 削除:[削除]アイコンをクリックして、データセットからフィールドを削除します。
- 保存:[保存]をクリックして、データセットに加えた変更を保存します。
ファイルのプロパティ
ファイルプロパティタブで、次のオプションを閲覧することができます:
- 日付パターン:ファイルパスで日付パターンを使用するためには、これを選択します。詳細については、ファイルを選択ステップ2aを参照してください。
- デフォルト日付形式:[日付形式]、[日時形式]、および[タイムゾーン]ドロップダウンリストからそれぞれ必要なパターンを検索または選択して、デフォルトの日付フォーマットを設定することができます。
- 追加の暗号化プロパティ: 暗号化プロパティの詳細については、ファイルを選択ステップ 2b~2hを参照してください。
また、Salesforce、MDAデータ、およびAmazon S3から更にデータセットを作成し、作成したデータセットに対してマージ、変換、およびその他のアクションを実行することも可能です。次に、[探索]タブに進んで、データを分析してレポートを作成することができます。
追加のリソース
- データセットを編集、マージ、または変換する方法については、データデザイナーでの準備の詳細を参照してください。
- データセットを探索する方法の詳細な手順については、データデザイナーで詳細を検索を参照してください。
- データセットを作成する方法の詳細な手順については、データデザイナーでのデータセットの作成を参照してください。
- データデザイナーでよくある質問の詳細については、データデザイナー FAQsを参照してください。