ローカルカタログレイヤー
OLP CLI は、次のものをサポートしています。
- ローカルカタログにレイヤーを追加します
- ローカルカタログでレイヤーを表示します
- ローカルカタログのレイヤーを更新します
- ローカルカタログのレイヤーを削除します
- ローカルカタログ内のレイヤーを検査します
ローカルカタログレイヤーが追加されました
注
ローカルカタログへのインタラクティブなマップレイヤーの追加は現在サポートされていません。
指定したレイヤーをローカルカタログに追加します。
olp local catalog layer add <catalog HRN> <layer ID> <layer name> <layer type> \
--summary <layer summary> [command options]
olp local catalog layer add <catalog HRN> <layer ID> <layer name> <layer type> ^
--summary <layer summary> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
追加するレイヤーの ID 。 -
<layer name>
レイヤーの人間が読める名前。 -
<layer type>
レイヤーのタイプ。 --versioned
、 --volatile
、 --stream
、、 --index
または --objectstore
。 -
--summary <layer summary>
レイヤーの内容を 1 行で要約します。 -
--description <layer description>
カタログおよびその内容の詳細な説明。 説明は引用符で囲んでください。
インデックス レイヤーの必須パラメータ :
-
--index-definitions <index-key-name:index-key-type[:duration][:zoom-level]>
レイヤーのインデックス定義 : -
index-key-name
は、クエリー API でクエリー述語を表現するために使用される名前です。 -
index-key-type
サポートされているキーのタイプについて説明します。 指定できる値は bool
、int
、 string
、 heretile
、または timewindow
です。 duration はタイルスライス timewindow
キーの長さを表し ます。 zoom-level はheretile
ズーム レベルを表します。
オプションのパラメータ :
-
--content-type <layer data type>
レイヤーのコンテンツタイプ。 application/vnd.geo+json
および text/plain
など。 デフォルト値はです application/x-protobuf
。 -
--content-encoding <encoding type>
など、レイヤーのコンテンツエンコード。 gzip
このパラメータを指定すると、レイヤー内のすべてのデータが指定したアルゴリズムで圧縮されます。 デフォルト値はです Uncompressed
。つまり、圧縮は行われません。 -
--tags <tag1 tag2 ..>
検索の検索に使用されるカタログキーワード。 -
--schema <schema HRN>
このレイヤーのデータスキーマの HERE リソースネーム 。 -
--billing-tags <tag1 tag2 ...>
請求タグのリスト。 検索の検出に使用されます。 -
--coverage <code1 code2 ...>
国および地域の ISO 3166 2 文字のコードのリスト。 オプションで、ドイツ DE
、ポーランド PL
、香港 CN-HK
、中国などのサブディビジョンに最大 3 文字のコードを付けます。 これらのコードはスペースで区切る必要があります。 -
--quiet
空の出力を追加情報なしで表示します。
ボラタイル レイヤーのオプションのパラメータ :
-
--max-memory-policy
ローカルカタログには使用されません。 -
--data-redundancy <single-instance|multi-instance>
ローカルカタログには使用されません。 -
--storage-capacity <size in MB>
ローカルカタログには使用されません。 -
--ttl
レイヤーの存続可能時間または有効期限 ( ミリ秒 ) 。 - 最大値 : 7 日 (604800000 ms);
- 最小値 : 1 分( 60000 ms ) ;
- デフォルト値 : 1 時間 (3600000 ミリ秒 ) 。
-
--digest <md5|sha-1|sha-256>
レイヤーのチェックサムの計算に使用するダイジェストアルゴリズム。 指定できる値は md5
、、 sha-1
、 sha-256
です。 -
--partitioning <generic|heretile[:tilelevel1,tilelevel2...]>
レイヤーのパーティション分割方式。 heretile
またはgeneric
のいずれか です。 で heretile
は tile levels
、などのコンマで区切って指定でき heretile:level1,level2
ます。 デフォルト値はです generic
。 --crc <CRC-32C>
巡回冗長検査の計算に使用されるアルゴリズム。現在サポート されているのは <CRC-32C>
のみです(大文字と小文字は区別されません。crc-32c
を使用できます)。
ストリーム レイヤーのオプションのパラメータ :
-
--data-in <size><KB|MB>
ローカルカタログには使用されません。 -
--data-out <size><KB|MB>
ローカルカタログには使用されません。 -
--parallelization <number of Kafka partitions>
ローカルカタログには使用されません。 -
--ttl <time in ms>
レイヤーの存続可能時間または有効期限 ( ミリ秒 ) 。 - 最大値 : 3 日( 259200000 ms ) ;
- 最小値 : 10 分( 600000 ms ) ;
- デフォルト値 : 1 時間 (3600000 ミリ秒 ) 。
バージョン付レイヤーのオプションのパラメータ :
-
--digest <md5|sha-1|sha-256>
レイヤーのチェックサムの計算に使用するダイジェストアルゴリズム。 指定できる値は md5
、、 sha-1
、または sha-256
です。 -
--partitioning <generic|heretile[:tilelevel1,tilelevel2...]>
レイヤーのパーティション分割方式。 heretile
またはgeneric
のいずれか です。 heretile
では、 heretile:level1,level2
などのコンマで区切って tile levels
指定できます。 デフォルト値はです generic
。 --crc <CRC-32C>
巡回冗長検査の計算に使用されるアルゴリズム。現在サポート されているのは <CRC-32C>
のみです(大文字と小文字は区別されません。crc-32c
を使用できます)。
インデックス レイヤーのオプションのパラメータ :
-
--ttl <time in dd, mm, yy>
インデックス レイヤー内のデータの存続可能時間または有効期限。 指定できる値は、 7.days
、 15.days
、 1.month
、 2.months
、 3.months
、 4.months
、 5.months
、 6.months
、 1.year
、 1.5.years
、 2.years
、および unlimited
。 デフォルトの TTL 設定はです 7.days
。 --crc <CRC-32C>
巡回冗長検査の計算に使用されるアルゴリズム。現在サポート されているのは <CRC-32C>
のみです(大文字と小文字は区別されません。crc-32c
を使用できます)。 -
--digest <md5|sha-1|sha-256>
レイヤーのチェックサムの計算に使用されるダイジェストアルゴリズム。 指定できる値は md5
、、 sha-1
、 sha-256
です。
例 :
以下のコマンドは、 ID new-layer
を持つ versioned
レイヤーを catalog1
に追加します。
olp local catalog layer add hrn:local:data:::catalog1 new-layer new-layer-name \
--versioned --summary "A summary"
olp local catalog layer add hrn:local:data:::catalog1 new-layer new-layer-name ^
--versioned --summary "A summary"
例 :
次のコマンドを実行すると、 md5
ダイジェスト、 heretile
パーティション分割、および tile levels
を含む versioned
レイヤーが catalog1
追加されます。
olp local catalog layer add hrn:local:data:::catalog1 new-layer new-layer-name \
--versioned --partitioning heretile:7,10,14 --digest md5 --summary "A summary"
olp local catalog layer add hrn:local:data:::catalog1 new-layer new-layer-name ^
--versioned --partitioning heretile:7,10,14 --digest md5 --summary "A summary"
ローカルカタログレイヤーが表示されます
レイヤーのプロパティを表示します。
olp local catalog layer show <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
表示するレイヤーの ID 。
オプションのパラメータ :
--json
コマンドの結果を JSON 形式で表示します。 -
--quiet
レイヤーのタイプと そのパーティション分割方式をスペースで区切って表示します。
例 :
以下のコマンドを使用すると test-layer
、内のプロパティが表示さ test-catalog
れます。
olp local catalog layer show hrn:local:data:::test-catalog test-layer --json
出力 :
{
"summary": "Summary",
"volume": { "volumeType": "durable" },
"layerType": "versioned",
"billingTags": [],
"crc": "CRC-32C",
"name": "Test Layer",
"description": "some description",
"partitioningScheme": "generic",
"partitioning": { "scheme": "generic" },
"id": "test-layer",
"contentType": "application/octet-stream",
"tags": []
}
ローカルカタログレイヤーが更新されました
ローカルカタログ内の指定したレイヤーを更新します。
olp local catalog layer update <catalog HRN> <layer ID> [command options]
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
更新するレイヤーの ID 。
オプションのパラメータ :
-
--name <layer name>
レイヤーの人間が読める名前。 -
--summary <layer summary>
レイヤーの内容を 1 行で要約します。 -
--description <layer description>
カタログおよびその内容の詳細な説明。 説明は引用符で囲んでください。 -
--tags <tag1 tag2 ...>
検索の検索に使用されるカタログキーワード。 -
--schema <schema HRN>
このレイヤーのデータスキーマの HERE リソースネーム 。 -
--billing-tags <tag1 tag2 ...>
検索の検索に使用される請求タグのリスト。 -
--coverage <code1 code2 ...>
国および地域の ISO 3166 2 文字のコードのリスト。 オプションで、ドイツ DE
、ポーランド PL
、香港 CN-HK
、中国などのサブディビジョンに最大 3 文字のコードを付けます。 これらのコードはスペースで区切る必要があります。 -
--quiet
空の出力を追加情報なしで表示します。
例 :
次のコマンドを使用すると、レイヤーの名前が old-layer
から newname
に更新され、タグが tag1
および tag2
に更新されます。
olp local catalog layer update hrn:local:data:::catalog1 old-layer --name newname \
--description "New Description" --tags tag1 tag2
olp local catalog layer update hrn:local:data:::catalog1 old-layer --name newname ^
--description "New Description" --tags tag1 tag2
ローカルカタログレイヤーを削除します
ローカルカタログ内の指定したストリーム、 volatile 、 index 、またはオブジェクト ストア レイヤーを削除します。 他のバージョン化されたレイヤー間の依存関係のため、バージョン化されたレイヤーを削除できません。
olp local catalog layer delete <catalog HRN> <layer ID> [command options]
警告
ローカルカタログのレイヤーを完全かつ復元不可能に削除すると、そのレイヤーに関連付けられているデータとメタデータの両方が削除されます。
必須パラメータ :
-
<catalog HRN>
カタログの HERE リソースネーム 。 -
<layer ID>
削除するレイヤーの ID 。
オプションのパラメータ :
-
--quiet
空の出力を追加情報なしで表示します。
例 :
以下のコマンドを使用すると、 hrn:local:data:::catalog1
カタログから some-layer
レイヤーが削除されます。
olp local catalog layer delete hrn:local:data:::catalog1 some-layer
ローカルカタログレイヤーの検査
ローカルデータ インスペクター を開き、指定したレイヤーを検査します。 レイヤーが適切に設定されている場合、データは視覚的に( HERE Tile レイヤーのみ)検査でき、構造的にも検査できます。 詳細については 、データ インスペクター ライブラリ のマニュアルを参照してください。 ローカルカタログまたはレイヤーが存在しない場合、コマンドは失敗します。
olp local catalog layer inspect <catalog HRN> <layer ID> [command options]
オプションのパラメータ :
-
--quiet
空の出力を追加情報なしで表示します。
注
olp local catalog layer inspect
このコマンドはローカルの Data API サーバーを起動し、プロセスが終了するまでユーザーに制御を戻しません。