Amazon DocumentDB での OpenSearch Ingestion パイプラインの使用

OpenSearch は Amazon DocumentDB 整数値を OpenSearch 整数に自動的にマッピングします。

OpenSearch は、最初に送信されたドキュメントに基づいてフィールドを動的にマッピングします。Amazon DocumentDB に同じ属性のデータ型が混在している場合、自動マッピングが失敗する可能性があります。

例えば、最初のドキュメントが long という属性を持っており、後のドキュメントがその同じ属性を integer として持っている場合、OpenSearch は 2 つ目のドキュメントの取り込みに失敗します。このような場合は、次のような、最も柔軟性が高い数値型を選択する明示的なマッピングテンプレートを提供する必要があります。

{
 "template": {
  "mappings": {
   "properties": {
    "MixedNumberField": {
     "type": "float"
    }
   }
  }
 }
}

Amazon DocumentDB は整数をサポートしています。

OpenSearch は、Amazon DocumentDB の long 値を OpenSearch の long に自動的にマッピングします。

OpenSearch は、最初に送信されたドキュメントに基づいてフィールドを動的にマッピングします。Amazon DocumentDB に同じ属性のデータ型が混在している場合、自動マッピングが失敗する可能性があります。

例えば、最初のドキュメントが long という属性を持っており、後のドキュメントがその同じ属性を integer として持っている場合、OpenSearch は 2 つ目のドキュメントの取り込みに失敗します。このような場合は、次のような、最も柔軟性が高い数値型を選択する明示的なマッピングテンプレートを提供する必要があります。

{
 "template": {
  "mappings": {
   "properties": {
    "MixedNumberField": {
     "type": "float"
    }
   }
  }
 }
}

Amazon DocumentDB は long をサポートしています。

OpenSearch は、文字列の値をテキストとして自動的にマッピングします。状況によっては (列挙型の値など)、キーワード型にマッピングできます。

次の例は、PartType という名前の Amazon DocumentDB 属性を、OpenSearch キーワードにマッピングする方法を示しています。

{
 "template": {
  "mappings": {
   "properties": {
    "PartType": {
     "type": "keyword"
    }
   }
  }
 }
}

Amazon DocumentDB は文字列をサポートしています。

OpenSearch は、Amazon DocumentDB の double 値を OpenSearch の double に自動的にマッピングします。

OpenSearch は、最初に送信されたドキュメントに基づいてフィールドを動的にマッピングします。Amazon DocumentDB に同じ属性のデータ型が混在している場合、自動マッピングが失敗する可能性があります。

例えば、最初のドキュメントが long という属性を持っており、後のドキュメントがその同じ属性を integer として持っている場合、OpenSearch は 2 つ目のドキュメントの取り込みに失敗します。このような場合は、次のような、最も柔軟性が高い数値型を選択する明示的なマッピングテンプレートを提供する必要があります。

{
 "template": {
  "mappings": {
   "properties": {
    "MixedNumberField": {
     "type": "float"
    }
   }
  }
 }
}

デフォルトでは、日付は OpenSearch の整数にマッピングされます。カスタムマッピングテンプレートを定義して、日付を OpenSearch 日付にマッピングできます。

{
 "template": {
  "mappings": {
   "properties": {
    "myDateField": {
     "type": "date",
     "format": "epoch_second"
    }
   }
  }
 }
}

デフォルトでは、タイムスタンプは OpenSearch の整数にマッピングされます。カスタムマッピングテンプレートを定義して、日付を OpenSearch 日付にマッピングできます。

{
 "template": {
  "mappings": {
   "properties": {
    "myTimestampField": {
     "type": "date",
     "format": "epoch_second"
    }
   }
  }
 }
}

OpenSearch は、Amazon DocumentDB のブール型を、OpenSearch のブール型にマッピングします。

Amazon DocumentDB はブール型属性をサポートしています。

OpenSearch は、Amazon DocumentDB のマップ属性を、ネストされたフィールドにマッピングします。同じマッピングがネストされたフィールド内でも適用されます。

次の例では、ネストされたフィールドの文字列を、OpenSearch のキーワード型にマッピングします:

{
 "template": {
  "mappings": {
   "properties": {
    "myDecimalField": {
     "type": "double"
    }
   }
  }
 }
}

このカスタムマッピングを使用すると、フィールドをクエリして、倍レベルの精度で集計できます。元の値は、OpenSearch ドキュメントの _source プロパティの完全な精度を保持します。このマッピングがない場合、OpenSearch はデフォルトでテキストを使用します。

Amazon DocumentDB は正規表現をサポートしています。

OpenSearch は、Amazon DocumentDB バイナリデータを OpenSearch テキストに自動的にマッピングします。これらを OpenSearch のバイナリフィールドとして書き込むためのマッピングを提供できます。

次の例は、imageData という名前の Amazon DocumentDB フィールドを、OpenSearch バイナリフィールドにマッピングする方法を示しています。

{
 "template": {
  "mappings": {
   "properties": {
    "imageData": {
     "type": "binary"
    }
   }
  }
 }
}

OpenSearch は、Amazon DocumentDB の null 型のドキュメントを取り込むことができます。値は null 値としてドキュメントに保存されます。この型にはマッピングがなく、このフィールドにはインデックスが付けられず、検索もできません。

同じ属性名が null 型に使用され、後で文字列などの別の型に変更される場合、OpenSearch は、最初の null 以外の値について動的マッピングを作成します。後続の値は引き続き Amazon DocumentDB の null 値にすることができます。

OpenSearch は、Amazon DocumentDB 未定義型のドキュメントを取り込むことができます。値は null 値としてドキュメントに保存されます。この型にはマッピングがなく、このフィールドにはインデックスが付けられず、検索もできません。

同じフィールド名が未定義型に使用され、後で文字列などの別の型に変更される場合、OpenSearch は、最初の未定義以外の値について動的マッピングを作成します。後続の値は引き続き Amazon DocumentDB の未定義の値にすることができます。

OpenSearch は、Amazon DocumentDB の minKey 型のドキュメントを取り込むことができます。値は null 値としてドキュメントに保存されます。この型にはマッピングがなく、このフィールドにはインデックスが付けられず、検索もできません。

同じフィールド名が minKey 型に使用され、後で文字列などの別の型に変更される場合、OpenSearch は、最初の minKey 以外の値について動的マッピングを作成します。後続の値は引き続き Amazon DocumentDB の minKey 値にすることができます。

OpenSearch は、Amazon DocumentDB の maxKey 型のドキュメントを取り込むことができます。値は null 値としてドキュメントに保存されます。この型にはマッピングがなく、このフィールドにはインデックスが付けられず、検索もできません。

同じフィールド名が maxKey 型に使用され、後で文字列などの別の型に変更される場合、OpenSearch は、最初の maxKey 以外の値について動的マッピングを作成します。後続の値は引き続き Amazon DocumentDB の maxKey 値にすることができます。

このメトリクスは、 AWS シークレットがローテーションされる頻度を示します。

このメトリクスは、 AWS シークレットの更新に失敗したことを示します。

このメトリクスは、Amazon DocumentDB からエクスポートされたレコードの数を示します。

このメトリクスは、OpenSearch Ingestion パイプラインによって処理されたレコードの数を示します。

このメトリクスは、Amazon DocumentDB クラスターからデータを読み取る際の OpenSearch Ingestion パイプラインの処理エラーの数を示します。

このメトリクスは、正常に処理されたエクスポートレコードの合計数を示します。

このメトリクスは、処理に失敗したエクスポートレコードの合計数を示します。

このメトリクスは、OpenSearch Ingestion パイプラインによって受信された合計バイト数を示します。

このメトリクスは、OpenSearch Ingestion パイプラインによって処理されたバイトの合計数を示します。

このメトリクスは、エクスポートパーティションの合計を示します。

このメトリクスは、ストリームから正常に処理されたレコードの数を示します。

このメトリクスは、ストリームから処理に失敗したレコードの合計数を示します。