データを階層のエンティティに分類するためのサービス
post
/spatialviewer/api/v1/categorizationJob
このサービスは、データを階層のエンティティに分類するための方法を提供します。大陸部、国、および州などの境界のレベルが定義されている一連の特定のカタログの場合、ユーザー・データのレコードを階層データ・セットの各レベルに結合できます。たとえば、大陸部/国/州/都市という階層内の指定されたHDFSファイルからすべてのツイッターを表示するために使用できます。
リクエスト
サポートされるメディア・タイプ
- application/json
問合せパラメータ
- 非同期
-
型:
boolean
trueの場合、この操作は非同期で実行されます。false
本文パラメータ
ジョブ詳細
ルート・スキーマ: CategorizationJobInfo
型:
object
- dataPath
-
型:
string
分類するHDFS内のファイルのパス。useIndexがfalseの場合は、このプロパティを指定します。例:/user/oracle/spatialviewer/tweetsJune.json
- indexName
-
型:
string
索引の名前。useIndexがtrueの場合は、このプロパティを指定します。例:TweetsJune
- inputFormatClass
-
型:
string
入力形式クラス。useIndexがfalseの場合は、このプロパティを指定します。例:oracle.spatial.hadoop.vector.geojson.mapred.GeoJsonInputFormat
- jarWithNeededClasses
-
型:
string
カスタムRecordInfoProviderまたはInputFormatのようなユーザー定義クラスを持つJAR名。InputFormatクラスまたはRecordInfoProviderクラスがAPI、またはHadoop APIクラスにない場合、ユーザー定義クラスのJARが提供されます。このjarを使用するには、/opt/oracle/oracle-spatial-graph/spatial/web-server/spatialviewer/WEB-INF/libディレクトリに追加し、サーバーを再起動する必要があります。useIndexがfalseの場合に設定可能なオプションのプロパティ。例:myjar.jar
- jobtemplates
-
型:
string
テーマ・マップ(ファイル名)を作成するためのテンプレート。フォルダ/opt/oracle/oracle-spatial-graph/spatial/vector/examplesの例では、国や地域のテンプレートのような一般的に使用されるテンプレートを提供しています。例:world_continents,world_countries,world_states_provinces
- outputPath
-
型:
string
Hadoopジョブの出力パス。例:/user/oracle/spatialviewer/catResult
- recordInfoProviderClass
-
型:
string
空間情報を提供するクラス。useIndexがfalseの場合は、このプロパティを指定します。例:oracle.spatial.hadoop.vector.geojson.GeoJsonRecordInfoProvider
- resultName
-
型:
string
結果名。例:Categorization TweetsJune
- useIndex
-
型:
boolean
索引が入力として使用される場合はtrue、それ以外の場合はfalse例:true
- useMVSuggest
-
型:
string
MVSuggestサービスを使用する必要があるかどうか。ジオメトリを場所の文字列から検出する場合は、MVSuggestサービスを使用します。この場合、指定されたRecordInfoProviderがインタフェース oracle.spatial.hadoop.vector.LocalizableRecordInfoProviderを実装する必要があります。フォルダ/opt/oracle/oracle-spatial-graph/spatial/vector/examplesのMVSuggest (データ・エンリッチメント・サービス)の使用方法の例を参照してください。useIndexがfalseの場合は、このプロパティを指定します。例:false
レスポンス
サポートされるメディア・タイプ
- application/json
200レスポンス
要求が成功しました。
レスポンスには、HDFS内の結果の場所が含まれています。
さらに、ジョブが完了すると、結果はSpatialViewerのローカル作業ディレクトリ(SpatialViewer構成を参照)に含まれているフォルダcategorization_resultsに保存されます。
レスポンスには、HDFS内の結果の場所が含まれています。
さらに、ジョブが完了すると、結果はSpatialViewerのローカル作業ディレクトリ(SpatialViewer構成を参照)に含まれているフォルダcategorization_resultsに保存されます。
本文
ルート・スキーマ: CategorizationJobResponse
型:
object
- o:successCode
-
型:
string
成功コード。例:SV-05003
- レスポンス
-
型:
string
レスポンスには、HDFS内の結果の場所が含まれています。例:hdfs://<namenode>:8020/user/oracle/spatialviewer/catResult
- ステータス
-
型:
string
成功またはエラー例:success
- タイトル
-
型:
string
サービスのタイトル。例:Create categorization job.
202レスポンス
非同期リクエストを受け入れました。
レスポンスには、ジョブを追跡するためのリソース・マネージャWebアプリケーションのURLが含まれています。
さらに、ジョブが完了すると、結果はSpatialViewerのローカル作業ディレクトリ(SpatialViewer構成を参照)に含まれているフォルダcategorization_resultsに保存されます。
レスポンスには、ジョブを追跡するためのリソース・マネージャWebアプリケーションのURLが含まれています。
さらに、ジョブが完了すると、結果はSpatialViewerのローカル作業ディレクトリ(SpatialViewer構成を参照)に含まれているフォルダcategorization_resultsに保存されます。
本文
ルート・スキーマ: AsyncCategorizationJobResponse
型:
object
- o:successCode
-
型:
string
成功コード。例:SV-05003
- レスポンス
-
型:
string
レスポンスには、ジョブを追跡するためのリソース・マネージャWebアプリケーションのURLの場所が含まれています(Hadoopパラメータyarn.resourcemanager.webapp.addressの構成を参照してください)。例:http://resource.mananger.webapp:8088
- ステータス
-
型:
string
成功またはエラー例:success
- タイトル
-
型:
string
サービスのタイトル。例:Create categorization job.