カタログレイヤーストリーム
OLP CLI は、次のものをサポートしています。
- ストリーム レイヤーからパーティションを取得します
- パーティションをストリーム レイヤーに配置します
- パーティションをストリーム レイヤーにインジェストします
カタログレイヤーストリーム GET
指定したストリーム レイヤーにサブスクライブし、サブスクリプション期間中にレイヤーにアップロードされたすべてのパーティションをダウンロードまたは印刷します。
olp catalog layer stream get <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
-
--output <path to dir>
ストリームから受信したデータを保存する出力ディレクトリ。 ファイルは、ストリームから受信したパーティションの名前で作成されます。 指定したディレクトリが存在しない場合は、自動的に作成されます。 ディレクトリが指定されていない場合、ストリームからのパーティションは、区切り文字で区切られた標準出力に出力されます。
注
ASCII 以外のシンボルを含むパーティションの内容を stdout に書き込みようとすると、コマンドによって空の出力が生成されることがあります。 これは、 Windows コンソールでの UTF-8 シンボルのレンダリングの特殊性に関連する、 Windows 固有の問題です。 回避 --output
策として、コマンド出力をファイルにリダイレクトするか、またはパラメーターで出力ディレクトリを指定してください。
-
--delimiter <character>
ストリームデータを標準出力に出力するために使用される区切り文字。デフォルトでは空です。
-
--limit <max number of paritions>
ダウンロードするパーティションの最大数。 -
--timeout <duration in seconds>
サブスクリプションのタイムアウト時間(秒単位)(デフォルトは infinite )。 -
--consumer-group <consumer ID>
消費者の名前、または消費者が配布されている場合はグループ。 -
--decode <true|false>
パーティションコンテンツを Protobuf からデコードし、その場で JSON に変換するかどうかを指定します。 デフォルト値はです false
。つまり、コンテンツはデコードされません。 を使用して、ローカルファイルシステムのスキーマへのパスを指定 --decode <true|false:[path/to/schema.zip]>
できます。指定しない場合は、レイヤーにリンクされているデフォルトのスキーマが使用されます。 レイヤーにリンクされているスキーマがないか、ローカルのスキーマ ZIP へのパスが指定されていない場合は、例外がスローされます。 スキーマは、 HERE platform ポータルまたは olp schema get
コマンドを使用してダウンロードできます。 --decode true
with --output
パラメーターを使用すると、次の名前パターンが使用されているファイルが作成 <partition-name>-decoded.json
されます。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
出力ディレクトリへの絶対パスがある場合は、そのパスを表示します。 それ以外の場合、パーティションの内容はストリームから標準出力に出力されます。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
以下のコマンドを実行すると、 catalog1
のすべてのパーティション stream-layer1
がデフォルトの空の区切り文字を使用して印刷されます。
olp catalog layer stream get hrn:here:data::org:catalog1 stream-layer1
カタログレイヤーストリーム PUT
ローカルマシンからカタログのストリーム レイヤーにコンテンツをパブリッシュします。
olp catalog layer stream put <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
--input <path to dir>
パーティションの読み取り元の入力ディレクトリ。 相対パスがサポートされています。 パーティションには、指定された入力ディレクトリをルートとするファイルツリーを移動することでデータが入力されます。 ファイルツリーは、まず深さを通り、辞書順で移動します。 指定しない場合、パーティションは標準入力から取得され、区切り文字で分割されます。 -
--delimiter <character>
標準入力からパーティションを読み取るために使用される区切り文字。 -
--limit <max number of partitions>
公開するパーティションの最大数。 -
--encode <true|false:[path/to/schema.zip]>
パーティションコンテンツが JSON からエンコードされ、その場で Protobuf に変換されるかどうかを指定します。 デフォルト値はです false
。つまり、コンテンツがエンコードされていません。 サポートされているレイヤーコンテンツタイプ : protobuf
ローカルファイルシステム上のスキーマへのパスを指定できます。指定しない場合は、レイヤーにリンクされているデフォルトのスキーマが使用されます。 レイヤーにリンクされているスキーマがないか、ローカルのスキーマ ZIP へのパスが指定されていない場合は、例外がスローされます。 スキーマは、 HERE platform ポータルまたは olp schema get
コマンドを使用してダウンロードできます。
-
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
以下のコマンドは、からすべてのパーティションをパブリッシュし /path/to/directory
ます。
olp catalog layer stream put hrn:here:data::org:catalog1 stream-layer1 --input /path/to/directory
カタログレイヤーのストリームインジェスト
ローカルマシンからカタログのストリーム レイヤーにコンテンツをパブリッシュします。
olp catalog layer stream ingest <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
レイヤーの ID 。
オプションのパラメータ :
--input <path to dir>
パーティションの読み取り元の入力ディレクトリ。 相対パスがサポートされています。 パーティションには、指定された入力ディレクトリをルートとするファイルツリーを移動することでデータが入力されます。 ファイルツリーは、まず深さを通り、辞書順で移動します。 指定しない場合、パーティションは標準入力から取得され、区切り文字で分割されます。 -
--delimiter <character>
標準入力からパーティションを読み取るために使用される区切り文字。 -
--limit <max number of partitions>
公開するパーティションの最大数。 -
--billing-tag <tag string>
課金レコードのグループ化に使用されるコスト割り当てのタグ。 -
--x-here-trace-id <trace ID>
このインジェストセッションの追跡に使用されるトレース ID 。 スキップすると、ランダムな UUID が代わりに生成されます。 -
--credentials <path to credentials file>
コマンドで使用する資格情報ファイルの名前。 資格情報ファイルは、プラットフォームポータルとは別にダウンロードされます。 -
--profile <profile name>
olpcli.ini
ファイルから使用する資格情報プロファイルの名前。 -
--quiet
空の出力を追加情報なしで表示します。 -
--scope <project HRN>
リクエストのスコープとして使用するプロジェクト HERE リソースネーム を指定します。 で指定された値 --scope
は here.token.scope
、コマンドに使用された資格情報ファイルで指定された値よりも優先されます。
資格情報 およびプロファイルの使用方法の詳細について は、「資格情報 の設定」を参照してください。
例 :
以下のコマンドは、からすべてのパーティションをパブリッシュし /path/to/directory
ます。
olp catalog layer stream ingest hrn:here:data::org:catalog1 stream-layer1 --input /path/to/directory