1.5 マップ・ビジュアライゼーション・コンポーネントの管理
このトピックでは、マップ・ビジュアライゼーション・コンポーネントの「管理」ページの概要と、ユーザーが実行できる管理および構成タスクの一部(新規データソースの追加、Oracle Mapsが使用するマップ・タイル層の管理、ロギング・レベルの設定など)について説明します。
1.5.1 マップ・ビジュアライゼーション・コンポーネントの「管理」ページへのログイン
マップ・ビジュアライゼーション・コンポーネントが適切に実行されていることを確認した後、マップ・ビジュアライゼーション・コンポーネントの「管理」ページにログインすることをお薦めします。そのためには、まずマップ・ビジュアライゼーション・コンポーネントの「ようこそ」ページ(通常はhttp://
<host>:<port>
/mapviewer
。<host>
および<port>
は、インストールの正しい値に置き換えてください)を表示します。
右上の「管理」リンクをクリックして、マップ・ビジュアライゼーション・コンポーネントの「管理」ページを表示します。
この管理ページを使用して、キャッシュ・データのクリア、タイル層の作成、タイル層の管理、サーバーの再起動(「モニタリング」リンクを使用して再起動)などの管理タスクを実行できます。
親トピック: マップ・ビジュアライゼーション・コンポーネントの管理
1.5.2 マップ・ビジュアライゼーション・コンポーネントの構成
マップ・ビジュアライゼーション・コンポーネントの実行のためのデフォルト構成設定が適切ではない場合、$MAPVIEWER_HOME
/WEB-INF/conf
ディレクトリにあるビジュアライゼーション・コンポーネント構成ファイルmapViewerConfig.xml
を編集して、マップ・ビジュアライゼーション・コンポーネントを構成できます。このファイルは、テキスト・エディタまたはマップ・ビジュアライゼーション・コンポーネントの「管理」ページで変更できます。
このファイルを変更したら、変更を反映するためにコンテナを再起動する必要がありますが、スタンドアロンGlassfishインスタンスとともにマップ・ビジュアライゼーション・コンポーネントをインストールしている場合、かわりにマップ・ビジュアライゼーション・コンポーネントの「管理」ページを使用して(他のアプリケーションがデプロイされ実行されている可能性のあるJava EEインスタンス全体ではなく)マップ・ビジュアライゼーション・コンポーネントのみを再起動できます。
マップ・ビジュアライゼーション・コンポーネント構成ファイルでは、次の情報がXML形式で定義されます。
-
ログ情報。コンテナ制御ロギング(推奨)または
<logging>
要素で定義されます(「ログ情報の指定」を参照) -
マップ画像ファイル情報。
<save_images_at>
要素で定義されます(「マップ・ファイル格納情報およびライフ・サイクル情報の指定」を参照) -
ファイアウォールを隔てた外部情報にアクセスするためのWebプロキシ情報。
<web_proxy>
要素で定義されます(「Webプロキシの指定」を参照) -
グローバル・マップ「ルック・アンド・フィール」構成。
<global_map_config>
要素で定義されます(「グローバル・マップ構成オプションの指定」を参照) -
内部空間データ・キャッシュの設定値。
<spatial_data_cache>
要素で定義されます(「空間データ・キャッシュのカスタマイズ」を参照) -
永続マップ・データソース。
<map_data_source>
要素で定義されます(「永続mapデータソースの定義」を参照) -
セキュリティ構成。
<security_config>
要素で定義されます。 -
WMSサービス構成。
<wms_config>
要素で定義されます。 -
外部属性データ・プロバイダ登録。
<ns_data_provider>
要素で定義されます。 -
マップ・タイル・サーバー構成。
<map_tile_server>
要素で定義されます。 -
UTFグリッドのライフサイクル・パラメータ。
<utfgrid_life_cycle>
要素で定義されます。 -
外部空間データ・プロバイダ登録。
<s_data_provider>
要素で定義されます。 -
マップ・データソース。
<map_data_source>
要素で定義されます。 -
マップ・データ・サーバーのストリーム・パラメータ。
<mds_config>
要素で定義されます。 -
OAMのログアウト・パラメータ。
<oam_logout>
要素で定義されます。
別途指定されていないかぎり、mapViewerConfig.xml
ファイルのすべてのパス名は、ファイルが格納されているディレクトリに対する相対パスです。
例1-1 サンプルのマップ・ビジュアライゼーション・コンポーネント構成ファイル
例1-1は、mapViewerConfig.xml
ファイルの例を示しています。
<?xml version="1.0" ?>
<!-- This is the configuration file for the map visualization component. -->
<!-- Note: All paths are resolved relative to this directory (where
this config file is located), unless specified as an absolute
path name.
-->
<MapperConfig>
<!-- ****************************************************************** -->
<!-- ************************ Logging Settings ************************ -->
<!-- ****************************************************************** -->
<!-- Uncomment the following to modify logging. Possible values are:
log_level = "fatal"|"error"|"warn"|"info"|"debug"|"finest"
default: info) ;
log_thread_name = "true" | "false" ;
log_time = "true" | "false" ;
one or more log_output elements.
-->
<!--
<logging log_level="info" log_thread_name="false"
log_time="true">
<log_output name="System.err" />
<log_output name="../log/mapviewer.log" />
</logging>
-->
<!-- ****************************************************************** -->
<!-- ********************** Map Image Settings ************************ -->
<!-- ****************************************************************** -->
<!-- Uncomment the following only if you want generated images to
be stored in a different directory, or if you want to customize
the life cycle of generated image files.
By default, all maps are generated under
$ORACLE_HOME/lbs/mapviewer/web/images.
Images location-related attributes:
file_prefix: image file prefix, default value is "omsmap"
url: the URL at which images can be accessed. It must match the 'path'
attribute below. Its default value is "%HOST_URL%/mapviewer/images"
path: the corresponding path in the server where the images are
saved; default value is "%ORACLE_HOME%/lbs/mapviewer/web/images"
Images life cycle-related attributes:
life: the life period of generated images, specified in minutes.
If not specified or if the value is 0, images saved on disk will
never be deleted.
recycle_interval: this attribute specifies how often the recycling
of generated map images will be performed. The unit is minute.
The default interval (when not specified or if the value is 0)
is 8*60, or 8 hours.
-->
<!--
<save_images_at file_prefix="omsmap"
url="http://mypc.mycorp.com:8888/mapviewer/images"
path="../web/images"
/>
-->
<!-- ****************************************************************** -->
<!-- ********************* IP Monitoring Settings ********************* -->
<!-- ****************************************************************** -->
<!-- Uncomment the following to enable IP filtering for administrative
requests.
Note:
- Use <ips> and <ip_range> to specify which IPs (and ranges) are allowed.
Wildcard form such as 20.* is also accepted. Use a comma-delimited
list in <ips>.
- Use <ips_exclude> and <ip_range_exclude> for IPs and IP ranges
prohibited from accessing eLocation.
- If an IP falls into both "allowed" and "prohibited" categories, it is
prohibited.
- If you put "*" in an <ips> element, then all IPs are allowed, except
those specified in <ips_exclude> and <ip_range_exclude>.
On the other hand, if you put "*" in an <ips_exclude> element, no one
will be able to access the map visualization component (regardless of whether an IP is in
<ips> or <ip_range>).
- You can have multiple <ips>, <ip_range>, <ips_exclude>, and
<ip_range_exclude> elements under <ip_monitor>.
- If no <ip_monitor> element is present in the XML configuration
file, then no IP filtering will be performed (all allowed).
- The way the map visualization component determines if an IP is allowed is:
if(IP filtering is not enabled) then allow;
if(IP is in exclude-list) then not allow;
else if(IP is in allow-list) then allow;
else not allow;
-->
<!--
<ip_monitor>
<ips> 138.1.17.9, 138.1.17.21, 138.3.*, 20.* </ips>
<ip_range> 24.17.1.3 - 24.17.1.20 </ip_range>
<ips_exclude> 138.3.29.* </ips_exclude>
<ip_range_exclude>20.22.34.1 - 20.22.34.255</ip_range_exclude>
</ip_monitor>
-->
<!-- ****************************************************************** -->
<!-- ********************** Web Proxy Setting ************************ -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to specify the web proxy setting.
This is only needed for passing background image URLs to
the map visualization component in map requests or for setting a logo image URL, if
such URLs cannot be accessed without the proxy.
-->
<!--
<web_proxy host="www-proxy.my_corp.com" port="80" />
-->
<!-- ****************************************************************** -->
<!-- *********************** Security Configuration ******************* -->
<!-- ****************************************************************** -->
<!-- Here you can set various security related configurations of the map visualization component.
-->
<security_config>
<disable_direct_info_request> false </disable_direct_info_request>
</security_config>
<!-- ****************************************************************** -->
<!-- *********************** Global Map Configuration ***************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to specify systemwide parameters
for generated maps. You can specify your copyright note, map title, and
an image to be used as a custom logo shown on maps. The logo image must
be accessible to this map visualization component and in either GIF or JPEG format.
Notes:
- To disable a global note or title, specify an empty string ("") for
the text attribute of <note> and <title> element.
- position specifies a relative position on the map where the
logo, note, or title will be displayed. Possible values are
NORTH, EAST, SOUTH, WEST, NORTH_EAST, SOUTH_EAST,
SOUTH_WEST, NORTH_WEST, and CENTER.
- image_path specifies a file path or a URL (starts with "http://")
for the image.
<rendering> element attributes:
- Local geodetic data adjustment: If allow_local_adjustment="true",
The map visualization component automatically performs local data
"flattening" with geodetic data if the data window is less than
3 decimal degrees. Specifically, the map visualization component performs a simple
mathematical transformation of the coordinates using a tangential
plane at the current map request center.
If allow_local_adjustment="false" (default), no adjustment is
performed.
- Automatically applies a globular map projection (geodetic data only):
If use_globular_projection="true", The map visualization component will
apply a globular projection on the fly to geometries being displayed.
If use_globular_projection="false" (the default), The map visualization component does no map
projection to geodetic geometries. This option has no effect on
non-geodetic data.
-->
<!--
<global_map_config>
<note text="Copyright 2009, Oracle Corporation"
font="sans serif"
position="SOUTH_EAST"/>
<title text="MapViewer Demo"
font="Serif"
position="NORTH" />
<logo image_path="C:\\images\\a.gif"
position="SOUTH_WEST" />
<rendering allow_local_adjustment="false"
use_globular_projection="false" />
</global_map_config>
-->
<!-- ****************************************************************** -->
<!-- ****************** Spatial Data Cache Setting ******************* -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to customize the spatial data cache
used by the map visualization component. The default is 64 MB for in-memory cache.
To disable the cache, set max_cache_size to 0.
max_cache_size: Maximum size of in-memory spatial cache of the map visualization component.
Size must be specified in megabytes (MB).
report_stats: If you would like to see periodic output of cache
statistics, set this attribute to true. The default
is false.
-->
<!--
<spatial_data_cache max_cache_size="64"
report_stats="false"
/>
-->
<!-- ****************************************************************** -->
<!-- ****************** Custom WMS Capabilities Info ****************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following tag if you want the map visualization component to
use the following information in its getCapabilities response.
Note: all attributes and elements of <wms_config> are optional.
-->
<!--
<wms_config host="www.my_corp.com" port="80">
<title>
WMS 1.1 interface for Oracle Map visualization component
</title>
<abstract>
This WMS service is provided through the map visualization component.
</abstract>
<keyword_list>
<keyword>bird</keyword>
<keyword>roadrunner</keyword>
<keyword>ambush</keyword>
</keyword_list>
<sdo_epsg_mapfile>
../config/epsg_srids.properties
</sdo_epsg_mapfile>
</wms_config>
-->
<!-- ****************************************************************** -->
<!-- **************** Custom Non-Spatial Data Provider **************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and add as many custom non-spatial data provider as
needed here, each in its own <ns_data_provider> element.
You must provide the id and full class name here. Optionally you
can also specify any number of global parameters, which the map visualization component
will pass to the data provider implementation during initialization.
The name and value of each parameter is interpreted only by the
implementation.
-->
<!-- this is the default data provider that comes with the map visualization component;
refer to the documentation on how to use it.
<ns_data_provider
id="defaultNSDP"
class="oracle.sdovis.NSDataProviderDefault"
/>
-->
<!-- this is a sample NS data provider with prameters:
<ns_data_provider
id="myProvider1" class="com.mycorp.bi.NSDataProviderImpl" >
<parameters>
<parameter name="myparam1" value="value1" />
<parameter name="p2" value="v2" />
</parameters>
</ns_data_provider>
-->
<!-- ****************************************************************** -->
<!-- ******************* Map Tile Server Setting ******************* -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to customize the map tile server.
<tile_storage> specifies the default root directory under which the
cached tile images are to be stored if the cache instance configuration
does not specify the root directory for the cache instance. If the
default root directory is not set or not valid, the default root
direcotry will be set to be $MAPVIEWER_HOME/web/tilecache
default_root_path: The default root directory under which the cached
tile images are stored.
-->
<!--
<map_tile_server>
<tile_storage default_root_path="/scratch/tilecachetest/"/>
</map_tile_server>
-->
<!-- ****************************************************************** -->
<!-- ******************** Predefined Data Sources ******************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to predefine one or more data
sources.
Note: You must precede the jdbc_password value with a '!'
(exclamation point), so that when the map visualization component starts the next
time, it will encrypt and replace the clear text password.
-->
<!--
<map_data_source name="mvdemo"
jdbc_host="elocation.example.com"
jdbc_sid="orcl"
jdbc_port="1521"
jdbc_user="scott"
jdbc_password="!password"
jdbc_mode="thin"
number_of_mappers="3"
/>
-->
</MapperConfig>
このマップ・ビジュアライゼーション・コンポーネントの構成トピックには、次のサブトピックがあります。
- ログ情報の指定
- マップ・ファイル格納情報およびライフ・サイクル情報の指定
- Webプロキシの指定
- グローバル・マップ構成オプションの指定
- 空間データ・キャッシュのカスタマイズ
- セキュリティ構成の指定
- カスタム空間プロバイダの登録
- カスタムな非空間データ・プロバイダの登録
- SRSマッピングのカスタマイズ
- WMS GetCapabilitiesレスポンスのカスタマイズ
- WMTS GetCapabilitiesレスポンスのカスタマイズ
- Oracle Maps用マップ・タイル・サーバーの構成
- 永続mapデータソースの定義
- HTML5 API用のマップ・データ・サーバーの構成および保護
親トピック: マップ・ビジュアライゼーション・コンポーネントの管理
1.5.2.1 ログ情報の指定
マップ・ビジュアライゼーション・コンポーネントには、ランタイム情報およびイベントを記録するための柔軟なロギング・メカニズムが備わっています。ログ出力の粒度、量、形式および出力先を設定できます。ログ・ファイルの最大サイズや、自動的なログ・ファイル・ローテーションも設定できます。
マップ・ビジュアライゼーション・コンポーネントのロギングを構成する方法は2つあります。コンテナ制御ロギングと、構成ファイルの<logging>
要素を使用する方法です。
コンテナ制御のロギング
mapViewerConfig.xml
ファイルの<logging>
要素がコメント・アウトされているか、見つからない場合、マップ・ビジュアライゼーション・コンポーネントはコンテナ制御ロギングを使用します。特に、次のログ出力を使用します。
-
すべてのWebサーバー(マップ、タイル、地物)のメッセージに、
oracle.mapviewer.ws
-
すべてのユーザー・アクセスに、
oracle.mapviewer.access
-
すべてのレンダリング(マップ、テーマ、地物)のメッセージに、
oracle.mapviewer.sdovis
-
すべての管理コンソールのログ・メッセージに、
oracle.mapviewer.webconsole
<logging>要素の使用
mapViewerConfig.xml
ファイルの<logging>
要素が使用中の場合(つまり、<logging>
要素がコメント・アウトされていないか、見つかる場合)、マップ・ビジュアライゼーション・コンポーネントはコンテナ制御ロギングを使用するかわりに、その情報を使用します。<logging>
要素は、次の属性とサブ要素を含むことができます。
-
console_log_level
属性では、ログに記録される情報のレベルが制御され、このレベルによってログ出力量が左右されます。console_log_level
属性には、FATAL
、ERROR
、WARN
、INFO
、DEBUG
およびFINEST
という値(ログ出力量が最も少ないレベルから最も多いレベルの順)を設定します。FATAL
レベルでは出力されるログ情報が最も少なくなり(回復不能なイベントのみがログに記録されます)、他のレベルでは前述にリストした順で含まれるログ情報が多くなり、FINEST
レベルではほとんどの情報がログに記録されます。本番作業では、WARN
またはより制限の大きいレベル(ERROR
またはFATAL
)をお薦めします。ただし、デバッグの場合は制限のより小さいレベルに設定する必要があります。 -
file_limit
属性は、ログ・ファイルの最大ファイル・サイズを制御します。単位はMb、デフォルト値は50 (つまり、ログ・ファイルの最大サイズのデフォルト値が50Mb)です。 -
file_count
属性は、作成されるログ・ファイルの数を決定します。ファイルはローテーションされます(つまり、最後のログ・ファイルが最大サイズに達すると、最初のログ・ファイルが再利用されます)。デフォルト値は10です。 -
<logger>
サブ要素では、特定のログ出力のログ・レベルを指定します。 -
<log_output>
サブ要素では、ログ情報の出力先が識別されます。デフォルトで、ログ・レコードはシステム・エラー・コンソールに書き込まれます。この設定は、システム出力コンソールまたは1つ以上のファイル、あるいはなんらかの組合せに変更できます。複数の<log_output>
サブ要素で複数のデバイスを指定した場合、ログ・レコードは、同じロギング・レベルおよび属性を使用してすべてのデバイスに送信されます。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.2 マップ・ファイル格納情報およびライフ・サイクル情報の指定
マップ画像ファイル情報は、<save_images_at>
要素で指定します。デフォルトで画像は、$ORACLE_HOME
/lbs/mapviewer/web/images
ディレクトリに格納されます。画像の格納用に別のディレクトリを指定する場合を除き、<save_images_at>
要素を変更する必要はありません。
マッピング・クライアントは、<map_request>
要素のformat
属性をGIF_URL
またはPNG_URL
に設定することで、マップ・ビジュアライゼーション・コンポーネントが実際のマップ画像データではなく画像ファイルのURLを返すようにリクエストできます。この場合、マップ・ビジュアライゼーション・コンポーネントは、リクエストされたマップ画像を、マップ・ビジュアライゼーション・コンポーネントが実行されているホスト・システム上にファイルとして保存し、画像ファイルのURLを含むレスポンスをマップ・クライアントに返します。
<save_images_at>
要素の属性として、次のマップ画像ファイル情報を指定できます。
-
file_prefix
属性では、マップ画像ファイル接頭辞が指定されます。マップ画像ファイル名は、固定のファイル接頭辞の後に、シリアル番号および画像型接尾辞が続きます。たとえば、マップ画像ファイル接頭辞がomsmap
である場合、考えられるGIFマップ画像ファイルにはomsmap1.gif
があります。デフォルト値:
file_prefix=omsmap
-
url
属性では、マップ画像のベースURLが指定されます。このURLは、マップ・ビジュアライゼーション・コンポーネント・ホスト上ですべてのマップ画像ファイルが保存されているディレクトリを指します。マッピング・クライアントに送信されるマップ画像URLは、マップ画像のベースURLにマップ画像ファイル名を加えたものです。たとえば、マップ画像のベースURLがhttp://dev04.example.com:1521/mapviewer/images
の場合、omsmap1.gif
のマップ画像URLはhttp://dev04.example.com:1521/mapviewer/images/omsmap1.gif
になります。デフォルト値:
url=
$HOST_URL
/mapviewer/images
-
path
属性では、マップ・ビジュアライゼーション・コンポーネント・ホスト・システム上ですべてのマップ画像ファイルが保存されるディレクトリのパスが指定されます。このディレクトリは、HTTPによるアクセスが可能で、マップ画像URLと一致する必要があります。path
属性で指定されたディレクトリに保存されたマップ画像ファイルは、url
属性で指定されたURLからアクセスできる必要があります。ただし、マップ・ビジュアライゼーション・コンポーネントをWebLogic Serverにデプロイする場合、
path
属性(../web/images
)のデフォルト値は正しくありません。この場合のパス属性は、../../images,
です。これは、物理的な"images"ディレクトリがmapviewer_23_2/web.war/images
であるためです。相対パスを使用すると、物理ディレクトリを解決するpath
属性の値は../../images
になります。 -
life
属性では、生成されたマップ画像が削除されるまでに確実にファイル・システム上にとどまる分数が指定されます。life
属性が指定された場合、recycle_interval
属性によって、マップ・ビジュアライゼーション・コンポーネントが削除対象のファイルの有無をチェックする頻度が制御されます。デフォルト: マップ・ビジュアライゼーション・コンポーネントは、生成されたマップ画像を削除しません。
-
recycle_interval
属性では、life
属性値の分数より長くファイル・システム上に存在する画像ファイルを削除できるかどうかをマップ・ビジュアライゼーション・コンポーネントがチェックする間隔が分数で指定されます。デフォルト値:
480
(8時間)
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.3 Webプロキシの指定
マップ・ビジュアライゼーション・コンポーネント・サーバーは、URLを介してバックグラウンド・イメージを取得したり、外部WMSサーバーに接続してそのマップ画像をフェッチしたりするために、外部Webサーバーに対してHTTP接続を実行する必要がある場合もあります。この場合、マップ・ビジュアライゼーション・コンポーネントとターゲットWebサーバー間にファイアウォールがある場合、ファイアウォールによってブロックされないように、マップ・ビジュアライゼーション・コンポーネントへのHTTPプロキシ情報を指定する必要があります。次の例では、Webプロキシ情報を指定しています。
<web_proxy host="www-proxy.mycorp.com" port="80" />
Webプロキシが認証を要求する場合は、user
およびpassword
属性を指定できます。パスワード値が感嘆符(!
)記号の後にある場合、パスワード値は最初に構成ファイルをロードしている間に暗号化されます。次に例を示します。
<web_proxy host="www-proxy.mycorp.com" port="80" user="uservalue" password="!pwdvalue" />
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.4 グローバル・マップ構成オプションの指定
マップ・ビジュアライゼーション・コンポーネントで生成される各マップの表示について、次のグローバル・ルックアンドフィール・オプションを指定できます。
-
タイトル
-
ノート (著作権の記述または脚注など)
-
ロゴ(カスタム・シンボルまたは企業ロゴ)
-
ローカル測地データ調整
-
子午線180度に沿ったジオメトリの分割
これらのオプションを指定するには、<global_map_config>
要素を使用します。次に例を示します。
<global_map_config> <note text="Copyright (c) 2009, Example Corporation" font="sans serif" position="SOUTH_EAST"/> <title text="Map Courtesy of Example Corp." font="Serif" position="NORTH"/> <logo image_path="C:\\images\\a.gif" position="SOUTH_WEST"/> <rendering allow_local_adjustment="false" use_globular_projection="false"/> </global_map_config>
マップ・タイトルは、<global_map_config>
要素の<title>
要素を使用して設定します。また、個々のマップ・リクエストで<map_request>
要素のtitle
属性を指定することで、マップ・タイトルを設定できます。この場合、マップ・ビジュアライゼーション・コンポーネント構成ファイル内のグローバル・タイトルのかわりに、マップ・リクエスト内のタイトルが使用されます。<title>
要素の属性については、次の点に注意してください。
-
text
属性ではタイトル文字列が指定されます。 -
font
属性ではフォントが指定されます。フォントが、マップ・ビジュアライゼーション・コンポーネントが実行されているシステムに存在している必要があります。 -
position
属性では、マップ上でのマップ・タイトルの描画位置を決定する際に、位置設定のヒントがマップ・ビジュアライゼーション・コンポーネントに提供されます。指定できる値は、NORTH
、EAST
、SOUTH
、WEST
、NORTH_EAST
、SOUTH_EAST
、SOUTH_WEST
、NORTH_WEST
およびCENTER
です。デフォルト値:
NORTH
マップの注釈は、<global_map_config>
要素の<note>
要素を使用して設定します。<note>
要素の属性については、次の点に注意してください。
-
text
属性ではノート文字列が指定されます。 -
font
属性ではフォントが指定されます。フォントが、マップ・ビジュアライゼーション・コンポーネントが実行されているシステムに存在している必要があります。 -
position
属性では、マップ上でのマップのノートの描画位置を決定する際に、位置設定のヒントがマップ・ビジュアライゼーション・コンポーネントに提供されます。指定できる値は、NORTH
、EAST
、SOUTH
、WEST
、NORTH_EAST
、SOUTH_EAST
、SOUTH_WEST
、NORTH_WEST
およびCENTER
です。デフォルト値:
SOUTH_EAST
マップ・ロゴは、<global_map_config>
要素の<logo>
要素を使用して設定します。マップ・ロゴ画像は、JPEGまたはGIFのいずれかの形式である必要があります。この画像は、ローカル・ファイル・システムに格納し、マップ・ビジュアライゼーション・コンポーネント・インスタンスが画像にアクセスできるようにするか、画像のURLを指定してWebから取得できます。マップ・ロゴを指定するには、マップ・ビジュアライゼーション・コンポーネント構成ファイルで<map_logo>
要素を非コメント化し、必要に応じてこの要素の属性を編集します。
<logo>
要素の属性については、次の点に注意してください。
-
image_path
属性では、有効なファイル・パス名またはhttp://
で始まるURLが指定される必要があります。 -
position
属性では、マップ上でのマップ・ロゴの描画位置を決定する際に、位置設定のヒントがマップ・ビジュアライゼーション・コンポーネントに提供されます。指定できる値は、NORTH
、EAST
、SOUTH
、WEST
、NORTH_EAST
、SOUTH_EAST
、SOUTH_WEST
、NORTH_WEST
およびCENTER
です。デフォルト値:
SOUTH_WEST
ファイアウォールの外側のURLからロゴ画像を取得する場合、マップ・ビジュアライゼーション・コンポーネントがロゴ画像を取得するためのWebプロキシの設定が必要となる場合があります。Webプロキシの指定については、「Webプロキシの指定」を参照してください。
また、マップ凡例を指定する場合は、凡例の位置がマップ・タイトル、ノートまたはロゴの位置と同じでないことを確認してください。(マップ凡例については、「マップ凡例」を参照してください。マップ凡例のデフォルト位置はSOUTH_WEST
です。)
マップ・データ・ウィンドウが3度(10進)未満の場合、マップ・ビジュアライゼーション・コンポーネントによって測地データが表示される前に、自動的にローカルの非測地座標系に投影されるようにするには、<rendering>
要素でallow_local_adjustment="true"
と指定します。
マップ・ビジュアライゼーション・コンポーネントにより球面投影(つまり、世界の表示に適したマップ投影であり、具体的にはマップ・ビジュアライゼーション・コンポーネントの正距方位図法があります)が自動的に適用されるようにするには、<rendering>
要素でuse_globular_projection="true"
と指定します。このオプションは測地データのみに適用されます。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.5 空間データ・キャッシュのカスタマイズ
マップ・ビジュアライゼーション・コンポーネントで空間データに使用されるメモリー内キャッシュをカスタマイズするには、<spatial_data_cache>
要素を使用します。次に例を示します。
<spatial_data_cache max_cache_size="64" report_stats="true" />
<spatial_data_cache>
要素の属性として、次の情報を指定できます。
-
max_cache_size
属性では、メモリー内キャッシュの最大MB数が指定されます。デフォルト値:
64
-
report_stats
属性は、true
に設定されている場合、マップ・ビジュアライゼーション・コンポーネント・サーバーに、キャッシュ済のオブジェクト数、キャッシュ・オブジェクト全体のサイズ、内部キャッシュ構造の効率に関するデータなど、キャッシュ統計を定期的(5分ごと)に出力するように指示します。統計はデータソースおよび事前定義済テーマごとに提供されます。これはメモリー内キャッシュの最適な設定を決定する場合に役立ちます。たとえば、メモリー・キャッシュに一部のテーマについてのすべてのジオメトリ・データを確保する場合は、これらのテーマを格納するのに十分なmax_cache_size
値を指定する必要があります。デフォルト値:
false
構成ファイルでこの要素がコメント化されている場合でも、空間データ・キャッシュはデフォルトで常に使用可能です。空間データのキャッシュを完全に使用不可にするには、max_cache_size
属性の値を0
(ゼロ)に指定する必要があります。
ノート:
前のリリースでサポートされていたディスクベースの空間キャッシュは、必要な場合(つまり、キャッシュ後にキャッシュ済オブジェクトを頻繁に再取得する必要がない場合)に、データベースから空間オブジェクトを直接フェッチするより効率が悪い場合が多いことがパフォーマンス・テストでわかったため、サポートされなくなりました。
事前定義済テーマのキャッシュの詳細は、「事前定義済テーマのキャッシュ」を参照してください。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.6 セキュリティ構成の指定
<security_config>
要素を使用すると、リクエスト内の<info_request>
要素をマップ・ビジュアライゼーション・コンポーネントが拒否するかどうかを指定できます。<info_request>
要素は、単純なSQL文を実行して結果行をプレーン・テキストまたはXML形式で返すようマップ・ビジュアライゼーション・コンポーネントに要求するクライアントからのリクエストのタイプです。このリクエストは、マップ・ビジュアライゼーション・コンポーネント・アプリケーションがマップに表示された地物を特定したり、単純な空間検索問合せを実行したりする際によく使用されます。
ただし、マップ・ビジュアライゼーション・コンポーネント・データソース情報を公開すると、悪質な攻撃者がこの機能を乱用し、機密情報を取得するおそれがあります。これを防止するには、アクセス権が非常に制限され、機密情報以外の情報しか提供しないデータベース・スキーマにマップ・ビジュアライゼーション・コンポーネントを常に接続するよう徹底する必要があります。また、次のように<security_config>
要素を指定して、<info_request>
リクエストをすべて拒否することもできます。
<security_config> <disable_direct_info_request> true </disable_direct_info_request> </security_config>
ただし、この設定は、一部のマップ・ビジュアライゼーション・コンポーネント機能に影響することに注意してください。たとえば、マップ・ビジュアライゼーション・コンポーネントJava APIのidentify()
メソッドが機能しなくなるので、アプリケーションでは他の手段を使用して独自のidentify()
メソッドを実装する必要があります。
マップ・ビジュアライゼーション・コンポーネントの組込みプロキシ・サーブレットの通信が許可されているリモートURLも定義できます。このようなURLを区切るには、カンマを使用します。URLを* (アスタリスク)ワイルドカード文字で終了すると、1つのパスで始まる複数のURLにできます。次の例では、1つのリモートURLを指定しています。
<security-config> … <proxy_enabled_hosts> foo.com:8080/mapviewer </proxy_enabled_hosts> … </security-config>
自己署名証明書を使用する、外部のWebサイトとのマップ・ビジュアライゼーション・コンポーネントのHTTPS (SSL)接続を容易にするために、ここでそれらの証明書を登録する場合があります。HTTPS接続が必要なサーバーのそれぞれに、1つのエントリを使用します。次の例は、1つのエントリの指定の一部を示しています。
<security_config> … <certificates> <entry> <host_name>fooserver.com</host_name> <keystore_file>/scratch/fooserver.jks</keystore_file> <key>123456</key> </entry> </certificates> … </security_config>
各証明書の<entry>
要素のサブ要素は、次のとおりです。
host_name
属性は、HTTPS接続が必要なサーバーのIPアドレスまたはドメイン名を指定します。
keystore_file
属性は、1つの自己署名証明書を含むファイルを指定します。サーバー・サイトから証明書(通常は.pem
ファイル)を取得すると、Javaのkeytool
コマンドを使用してキー・ストアを作成できます。次に例を示します。
keytool -import -file fooserver.pem -alias fooserver -keystore fooserver.jks
key
属性は、キー・ストア・ファイルの作成時にユーザーが提供したパスワードを指定します。(これは、キー・ストア・ファイル自体の整合性を確実にするために使用されます。)
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.7 カスタム空間プロバイダの登録
マップ・ビジュアライゼーション・コンポーネントでは、シェイプファイルなどの外部(Oracle Spatial以外)のネイティブ形式用に登録された空間プロバイダの実装があれば、その形式の空間データをレンダリングできます。(カスタム・ジオメトリ・テーマに関連付けられる)外部空間データ・プロバイダの実装については、「カスタム・ジオメトリ・テーマ」を参照してください。
外部空間データ・プロバイダを登録するには、次の例のように<s_data_provider>
要素を使用します。
<s_data_provider id="shapefileSDP" class="oracle.sdovis.ShapefileDataProvider" > <parameters> <parameter name="datadir" value="/temp/data" /> </parameters> </s_data_provider>
class
属性では、外部空間データ・プロバイダを実装するクラスの名前を指定します。
<parameters>
要素では、該当するデータ・プロバイダがその初期化プロセスで使用する一連の初期化パラメータを指定します。この例では、シェイプファイル・プロバイダのデータ・ディレクトリ・("datadir
"
)パラメータによって、マップ・ビジュアライゼーション・コンポーネントがデータを検索するディレクトリが示されています。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.8 カスタムな非空間データ・プロバイダの登録
テーマ・マップ層の生成時、マップ・ビジュアライゼーション・コンポーネントは外部ソースから生成される(各地域の売上高のような)非空間属性データと、データベースに格納されているベース・ジオメトリ(全地域の境界線)を結合できます。非空間データ・プロバイダの外部属性データを使用したテーマ・マッピングについては、「外部属性データを使用したテーマ・マッピング」を参照してください。
非空間データ・プロバイダを登録するには、次の例のように<ns_data_provider>
要素を使用します。
<ns_data_provider id="testProvider" class="com.mycorp.GetSalesData" > <parameters> <parameter name="bi_database" value="stadb32.mycorp.com" /> <parameter name="sid" value="bidata" /> </parameters> </ns_data_provider>
id
属性では、非空間データ・プロバイダを一意に指定します。このid
値は、該当するプロバイダに関連するすべてのマップ・リクエストで使用します。
class
属性では、非空間データ・プロバイダを実装するクラスの名前を指定します。
<parameters>
要素では、非空間データ・プロバイダがその初期化プロセスで使用する一連の初期化パラメータを指定します。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.9 SRSマッピングのカスタマイズ
<srs_mapping>
要素を使用すると、SDO SRIDからEPSG SRIDへのマッピング・ファイルを指定できます。このファイルで、Oracle SpatialのSDO_SRID値とEPSGコードの間のマッピングを定義します。「SDO SRIDからEPSG SRIDへのマッピング・ファイル」で説明するように、指定したマッピング・ファイルの各行には、SDO_SRID値とそれに対応するEPSGコードが含まれている必要があります。<srs_mapping>
要素は、WMSテーマおよびWFSテーマで使用できます。
次の例では、<srs_mapping>
要素を使用してSDO SRIDからEPSG SRIDへのマッピング・ファイルを指定しています。
<srs_mapping> <sdo_epsg_mapfile> ../config/epsg_srids.properties </sdo_epsg_mapfile> </srs_mapping>
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.10 WMS GetCapabilitiesレスポンスのカスタマイズ
マップ・ビジュアライゼーション・コンポーネントは、Open Geospatial Consortium Web Map Server (WMS) 1.1.1に準拠したサーバーとして使用できます。したがって、WMSクライアントは、マップ・ビジュアライゼーション・コンポーネントにGetCapabilities
リクエストを送信できます。マップ・ビジュアライゼーション・コンポーネントはレスポンスで、保持しているテーマのリストおよびリクエスト元のクライアントにとって重要な、データ・プロバイダの名前、キーワードのリストなどの情報を返送します。
ノート:
マップ・ビジュアライゼーション・コンポーネント構成ファイルの<wms_config>
要素の情報よりも多くの情報を格納している個別のWMSファイル(wmsConfig.xml
)があります。どのようなカスタムWMS構成パラメータも、この個別のWMS構成ファイルで定義することをお薦めします。このファイルの設定は、マップ・ビジュアライゼーション・コンポーネント構成ファイルの<wms_config>
要素の設定と競合するものをすべてオーバーライドします。
wmsXonfig.xmlファイルの詳細は、「GetCapabilitiesレスポンスのカスタマイズ: 追加オプション」を参照してください。
次の例のように<wms_config>
要素を使用すると、GetCapabilities
レスポンスの一部としてクライアントに返送する説明情報をカスタマイズすることができます。
<wms_config host="www.my_corp.com" port="80" protocol="http" default_datasource="dsrc1" public_datasources="dsrc1,dsrc2"> <title> WMS 1.1 interface for Oracle Application Server 10g MapViewer </title> <abstract> This WMS service is provided through Oracle MapViewer. </abstract> <keyword_list> <keyword>bird</keyword> <keyword>roadrunner</keyword> <keyword>ambush</keyword> </keyword_list> <sdo_epsg_mapfile> ../config/epsg_srids.properties </sdo_epsg_mapfile> </wms_config>
host
属性では、該当するマップ・ビジュアライゼーション・コンポーネント・サーバーに発行される今後のWMSリクエストでクライアントが使用するサービス・リクエストURLのホスト部を指定します。
port
属性では、該当するマップ・ビジュアライゼーション・コンポーネント・サーバーに発行される今後のWMSリクエストでクライアントが使用するサービス・リクエストURLのポート部を指定します。
protocol
属性では、該当するマップ・ビジュアライゼーション・コンポーネント・サーバーに発行される今後のWMSリクエストでクライアントが使用するサービス・リクエストURLのプロトコル部を指定します。
default_datasource
属性は、機能レスポンスの取得に使用される基本データソースを指定します。この属性が定義されていない場合、データソースWMS
が使用され、そのデータソースがこのマップ・ビジュアライゼーション・コンポーネント・サーバーに存在する必要があります。
public_datasources
属性では、GetCapabilitiesレスポンスでどのデータソース・コンテンツをリストするかを指定します。この属性が定義されていない場合、すべてのデータソース・コンテンツがリストされます。
<title>
要素では、レスポンスの一部として含めるサービス・タイトルを指定します。
<abstract>
要素では、レスポンスの一部として含める概要を指定します。
<keyword_list>
要素では、該当するマップ・ビジュアライゼーション・コンポーネント・サーバーによってサービスが提供される層のタイプを最もよく表現するキーワードのリストを指定します。
<sdo_epsg_mapfile>
要素では、Oracle Spatial (SDO) SRID値から対応するEPSG SRID値(ほとんどのWMSリクエストおよびレスポンスで一般に使用される値)へのマッピングを定義するテキスト・ファイルを指定します。このマッピング・ファイルの詳細は、「SDOからEPSG SRIDへのマッピング・ファイル」を参照してください。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.11 WMTS GetCapabilitiesレスポンスのカスタマイズ
マップ・ビジュアライゼーション・コンポーネントは、Open Geospatial Consortium WMTS (Web Map Tile Service) 1.0.0に準拠したサーバーとして使用できます。これにより、WMTSリクエストを使用して、USER_SDO_CACHED_MAPSメタデータ・ビューに定義されたタイル層を取得できます。WMTSクライアントは、マップ・ビジュアライゼーション・コンポーネントにGetCapabilities
リクエストを送信できます。マップ・ビジュアライゼーション・コンポーネントはリクエスト元のクライアントにとって重要な、自ら保持しているタイル層のリストや、データ・プロバイダの名前、キーワードのリストなどの情報をレスポンスで返送します。mapViewerConfig.xml
と同じフォルダに格納された、wmtsConfig.xml
という名前のWMTS構成ファイルを編集すると、このようなカスタマイズされた情報を提供できます。
次の例のように、wmtsConfig.xml
の<wmts_config>
要素を使用して、GetCapabilities
レスポンスの一部としてクライアントに返送する説明情報をカスタマイズできます。
<wmts_config> <public_datasources> <public_datasource name="MVDEMO" include_all_tile_layers="true"/> <public_datasource name="ELOCATION"> <tile_layers> <tile_layer name="WORLD_MAP"/> </tile_layers> </public_datasource> </public_datasources> <sdo_epsg_mapfile> ../config/epsg_srid.properties </sdo_epsg_mapfile> <ServiceAttributes> <ServiceIdentification> <Title>Web Map Tile Service by myCorp</Title> <Abstract> U.S. maps for state and county boundaries and big cities</Abstract> <Keywords> <Keyword>Maps,U.S. State Boundaries,Cities</Keyword> </Keywords> </ServiceIdentification> <ServiceProvider> <ProviderName>provider's name</ProviderName> <ProviderSite url="http://www.myCorp.com/mySite"/> </ServiceProvider> </ServiceAttributes> </wmts_config>
<public_datasources>
要素に、<public_datasource
>下位要素を含めることができます。この下位要素は、WMTS GetCapabilitiesレスポンスにリストされるタイル層のデータソースを指定します。この<public_datasources>
要素が定義されていない場合は、すべてのデータ・ソースのタイル層がリストされます。また、この要素が定義されているが、<public_datasource>
下位要素が含まれていない場合、データ・ソースからのタイル層はレスポンスにリストされません。
<public_datasource>
要素にはname
属性を含める必要があります。この属性は、データ・ソースの名前を示します。
include_all_tile_layers
属性はオプションであり、デフォルトはfalse
です。true
に設定すると、そのデータ・ソースのすべてのタイル層がレスポンスにリストされます。
<tile_layer>
要素にはname
属性を含める必要があります。この属性は、親要素に定義されたデータ・ソースからレスポンスに含めるタイル層の名前を示します。
<sdo_epsg_mapfile>
要素では、Oracle Spatial (SDO) SRID値から対応するEPSG SRID値(ほとんどのWMTSリクエストおよびレスポンスで一般に使用される値)へのマッピングを定義するテキスト・ファイルを指定します。このマッピング・ファイルの詳細は、「SDOからEPSG SRIDへのマッピング・ファイル」を参照してください。
<Title>
要素は、レスポンスの一部として含めるサービス・タイトルを指定します。
<Abstract>
要素は、レスポンスの一部として含める概要を指定します。
<Keywords>
要素は、マップ・ビジュアライゼーション・コンポーネント・サーバーによって処理される層のタイプを最も適切に表す一連のキーワード(<Keyword>
下位要素)を指定します。
詳細は、wmtsConfig.xml
ファイルのコメントを参照してください。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.12 Oracle Maps用マップ・タイル・サーバーの構成
マップ・ビジュアライゼーション・コンポーネントのOracle Maps機能では、ベース・マップ画像タイルを事前に生成し、マップ・タイル・サーバーを使用してそれらをキャッシングすることができます。<map_tile_server>要素を使用すると、次の例のように、マップ・タイル・ファイルのデフォルトの格納先やログ情報などの構成情報をマップ・タイル・サーバーに提供できます。
<map_tile_server> <tile_storage default_root_path="/scratch/tilecache/" /> <logging log_level="finest" log_thread_name="false" log_time="true"> <log_output name="System.err"/> </logging> </map_tile_server>
<tile_storage>
要素では、該当するマップ・ビジュアライゼーション・コンポーネント・サーバーによって生成されるすべてのマップ画像タイルが格納されるデフォルトのルート・ディレクトリを指定します。
<logging>
要素では、マップ・タイル・サーバーに固有なログ情報を指定します。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.13 永続mapデータソースの定義
すべてのマップ・リクエストには、地理空間データを持つデータベース・ユーザーである、マップ・データソースを指定するデータソース属性が必要です。使用可能なマップ・データソースを事前定義するには、<map_data_source>
要素を使用します。たとえば、次の例では、JDBC接続の詳細を指定してマップ・データソースを定義します。
<map_data_source name="mvdemo"
jdbc_host="mapsrus.example.com"
jdbc_sid="orcl"
jdbc_port="1521"
jdbc_user="scott"
jdbc_password="<password_for_scott>"
jdbc_mode="thin"
number_of_mappers="5"
allow_jdbc_theme_based_foi="true"
plsql_package="web_user_info"
/>
<map_data_source>
要素の属性として、次の情報を指定できます。
-
name
属性では、マップ・ビジュアライゼーション・コンポーネントに対して一意のデータソース名を指定します。データソースを識別するすべてのマップ・リクエストで、データソース名を指定する必要があります。 -
次のいずれかのオプションを選択して、シナリオに該当する接続詳細を指定できます。
- 必要なすべてのJDBC接続情報の指定
次の接続情報を指定できます。
jdbc_host
: データベースのホスト名jdbc_sid
: データベースのシステム識別子jdbc_port
: データベース・リスナー・ポートjdbc_user
: データベース・ユーザー名jdbc_password
:jdbc_user
のパスワードjdbc_mode
: Oracle JDBCドライバのタイプ
jdbc_password
属性では、データベース・ユーザーのログイン・パスワードを指定します。初めてパスワードを指定する場合は、先頭に感嘆符(!)を付ける必要があります。次のマップ・ビジュアライゼーション・コンポーネントの再起動時に、クリア・テキスト・パスワードは自動的に不明瞭化され、置き換えられます。マップ・ビジュアライゼーション・コンポーネントによってこのパスワード文字列が変更されることはありません。大文字または小文字の変換も行われません。データベースで大/小文字を区別したパスワードが使用される場合は、指定したパスワードがデータベースのパスワードと完全に一致する必要があります。
jdbc_mode
属性では、データベースに接続する際に使用するOracle JDBCドライバがマップ・ビジュアライゼーション・コンポーネントに通知されます。デフォルトはthin
(シン・ドライバ)です。その他の可能な値はoci8
です。この場合、マップ・ビジュアライゼーション・コンポーネントが動作するホスト上にOracle Databaseクライアントもインストールされている必要があります。データベースの再起動時に、データベースがオンラインに戻るとすぐに、マップ・ビジュアライゼーション・コンポーネントは通常の操作(たとえば、適切に作成されたマップでマップ・リクエストに応答するなど)を再開します。
- コンテナ・データソース名の指定
container_ds
属性を使用すると、jdbc_host
、jdbc_sid
、jdbc_port
、jdbc_user
、jdbc_password
およびjdbc_mode
の各属性を指定するかわりに、Java EEコンテナの名前(JNDI名)を指定できます。たとえば、JDBCデータソースを作成し、そのデータソースにjdbc/OracleDS
というJNDI名を付けたとします。その後、永続マップ・ビジュアライゼーション・コンポーネント・データソースを次のように定義できます。<map_data_source name="mvdemo" container_ds="jdbc/OracleDS" number_of_mappers="5" />
container_ds
属性を使用し、データソースを定義したデータベースの再起動後すぐにマップ・ビジュアライゼーション・コンポーネントが通常の動作(たとえば、マップ・リクエストに正しく作成されたマップで応答するなど)を自動的に再開するようにする場合は、アプリケーションに戻される前に必ず接続を検証するように、コンテナ・データソースに指示する必要があります。マップ・ビジュアライゼーション・コンポーネントの本番デプロイメントでは、最大限のセキュリティを確保するために、この方法でデータソースを定義することをお薦めします。
- ネット・サービス名の指定
jdbc_tns_name
属性では、tnsnames.ora
ファイルで定義されているネット・サービス名を識別します。データベースの再起動時に、データベースがオンラインに戻るとすぐに、マップ・ビジュアライゼーション・コンポーネントは通常の操作(たとえば、適切に作成されたマップでマップ・リクエストに応答するなど)を再開します。
- Autonomous Database (ADB)資格証明の指定
これは、マップ・データソースとしてOracle Autonomous Databaseを使用している場合に適用されます。この場合、ウォレットzipファイルのクライアント資格証明を使用してMapViewerデータソースを作成できます。MapViewerサーバーがファイアウォールの内側で実行されていて、Autonomous Databaseにアクセスするためのプロキシ・サーバーが必要な場合は、プロキシ・サーバーのホストおよびポートの詳細を指定する必要があります。
次に、ウォレットzipファイルの格納場所を定義するための様々な選択肢を検討します。
- オプション1: ダウンロードしたウォレットzipファイルをMapViewerサーバーがデプロイされているマシンにコピーし、その絶対パスを次のように指定します。
<map_data_source name="adb_no_proxy" wallet_zip_file="/home/myfolder/mywallets/<wallet_filename>.zip" user="myCloudDBUser" password="<password_for_myCloudDBUser>" service="db20220510_low" number_of_mappers="5" allow_jdbc_theme_based_foi="false" />
- オプション2: ダウンロードしたウォレットzipファイルをMapViewerサーバーがデプロイされているマシンにコピーし、その相対パスを指定します。これは、
mapViewerConfig.xml
ファイルが格納されている場所からの相対パスです。次に例を示します。<map_data_source name="adb_require_proxy" wallet_zip_file="../wallets/<wallet_filename>.zip" user="myCloudDBUser" password="<password_for_myCloudDBUser>" service="db20220510_low" proxy_host="<proxy_host_name>" proxy_port="80" number_of_mappers="5" allow_jdbc_theme_based_foi="false" />
- オプション3: URLを使用してウォレットzipファイルを定義します。URLは、MapViewerサーバーによってアクセス可能である必要があります。次に例を示します。
<map_data_source name="adb_url" wallet_zip_file="https://objectstorage.<region_identifier>.oraclecloud.com/p/b/<bucket_name>/o/<wallet_filename>.zip" user="myCloudDBUser" password="<password_for_myCloudDBUser>" service="db20220510_high" number_of_mappers="5" allow_jdbc_theme_based_foi="false" />
service
属性は、tnsnames.ora
ファイル内にあります。このファイルは、ウォレットzipファイルを解凍することで取得されます。tnsnames.ora
ファイルには、<service_name>_high
、<service_name>_medium
、<service_name>_low
などの3つのサービス名が含まれています。好みに応じていずれかを選択できます。user
やpassword
などのその他の属性については、この項で前に説明したjdbc_user
およびjdbc_password
を参照してください。
MapViewerサーバーは、起動するたびに、ファイル・システムからウォレットzipファイルにアクセスするか、指定されたリンクからダウンロードしようとします。ウォレットzipファイルの記憶域の場所がURLで提供されている場合、MapViewerサーバーはzipファイルをダウンロードして一時フォルダに格納します。MapViewerサーバーはウォレット・ファイルをこのzipファイルが格納されているフォルダに解凍するため、フォルダが書込み可能であることを確認してください。
- オプション1: ダウンロードしたウォレットzipファイルをMapViewerサーバーがデプロイされているマシンにコピーし、その絶対パスを次のように指定します。
- 必要なすべてのJDBC接続情報の指定
-
number_of_mappers
属性では、このデータソースで使用可能なマップ・レンダラの最大数(つまり、このデータソースでマップ・ビジュアライゼーション・コンポーネントが同時に処理できるマップ・リクエストの最大数)を指定します。未処理のマップ・リクエストはキューに入れられ、最終的には処理されます。たとえば、この値が3の場合、マップ・ビジュアライゼーション・コンポーネントでは最大3つのマップ・リクエストを同時に処理できます。3つのリクエストの処理中に送信された4つ目のマップ・リクエストは、マップ・ビジュアライゼーション・コンポーネントが現在のリクエストのいずれかの処理を完了するまで待機します。number_of_mappers
に大きな値(50、100など)を指定すると、全体的なスループットを向上できますが、マップ・ビジュアライゼーション・コンポーネントがより多くの同時マップ・リクエストを処理しようとするため、ピーク負荷時のランタイム・メモリーとCPU使用率も増加させることになります。これは、アクティブなデータベース・セッションの数も増加させます。したがって、この属性にあまり大きな数値を設定しないようにしてください。ノート:
廃止される
max_connections
属性は、レンダリングに影響を与えなくなり、無視されます。number_of_mappers
属性の値は、データソースに対して常にオープンになっているデータベース接続またはセッションの実際の最大数に影響を与えます。 -
allow_jdbc_theme_based_foi
属性を使用すると、該当するデータソースに対するJDBCテーマベースのFOIリクエストの実行を許可するかどうかを指定できます。JDBCテーマベースのFOIリクエストは、JavaScriptクライアント・アプリケーションによって作成された動的SQL問合せに基づくものです。デフォルトでは、そのようなFOIリクエストは、この属性を
true
に設定しないかぎり、許可されません。セキュリティ侵害のおそれがあるため、JDBCテーマベースのFOIリクエストは注意して使用する必要があります。JDBCテーマベースのFOIリクエストは、非常に低い権限しか付与されず、公開対象のデータしか含まれないデータベース上でのみ許可してください。 -
plsql_package
属性を使用すると、セキュアなマップ・レンダリング用に使用するPL/SQLパッケージを指定できます(セキュアなマップ・レンダリングを参照)。 -
web_user_type
属性(この項の例には表示されていません)を使用すると、認証済ユーザー名のソースを指定できます。これは、セキュアなソース・レンダリングで使用するPL/SQLパッケージの指定とあわせてCookieから認証済ユーザー名を取得する場合に特に有効です。web_user_type
属性および使用例の詳細は、Cookieからのユーザー名の取得を参照してください。
- データソース
データソースは、データベースのスキーマまたはユーザーに対応します。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.2.13.1 データソース
データソースは、データベースのスキーマまたはユーザーに対応します。
データベース・スキーマ内で空間データを描画するには、まずそのスキーマ用のデータソースを定義(作成)する必要があります。
-
マップ・ビジュアライゼーション・コンポーネント構成ファイル(
mapViewerConfig.xml
)で接続情報およびユーザー・ログイン資格証明を指定すると、データソースを定義できます。 -
マップ・ビジュアライゼーション・コンポーネントの管理(Admin)ページを使用すると、データソースを定義または変更できます。
各マップ・リクエストでは、データソースを指定する必要があります。ただし、マップ・リクエストに追加された個々のテーマには異なるデータソースを指定できます。これにより、異なるデータベース・スキーマに格納されているデータの集約が容易になります。データソースが指定されていないテーマは、マップ・リクエストのデータソースに関連付けられます。ベース・マップ(したがって、それに含まれるテーマ)は、常にデータソースに関連付けられます。テーマを処理する際、定義で参照されるスタイルと同様に、基礎となるデータはすべてそのテーマに関連付けられたデータソースからアクセス可能であることが必要です。
各データソースには、関連付けられたレンダラ(マッパーまたはマップ・メーカーとも呼ばれる)があります。その数は、<map_data_source>
要素のnumber_of_mappers
属性で定義されています。この属性(「永続mapデータソースの定義」を参照)は、マップ・リクエストの処理時に、データソースごとに作成されるデータベース接続数に影響を与えます。データソースで指定されたレンダラの数は、そのデータソースに対して処理可能な同時リクエストの最大数でもあります。各追加レンダラに必要なメモリーの量はわずかですが、多数(100など)のレンダラを指定すると、処理が認められたマップ・リクエスト数が多すぎる場合に基礎となるCPUリソースに負荷がかかり、マップ・ビジュアライゼーション・コンポーネント・サーバー全体のパフォーマンスに影響を及ぼすという不都合が生じる可能性があります。
各データソースには、独自の内部メタデータ・キャッシュがあります。メタデータ・キャッシュには、そのデータソースから作成されたすべての事前定義済テーマやアクセス済の全スタイルの定義が保持されています。これにより、必要なときにスタイルや事前定義済テーマを繰り返しデータベースに問い合せる必要がなくなります。
親トピック: 永続mapデータソースの定義
1.5.2.13.1.1 カタログ・データ・ソース
カタログ・データ・ソースは、すべてのデータをローカル・ファイルから取得します。データ・ファイルが保存されているローカル・ディレクトリは、mapViewerConfig.xml
ファイルが保存されている場所を基準とします。別の観点から考えると、カタログ・データ・ソースにはOracleデータベースが必要ないことになります。これは、必要なデータのすべて(空間ジオメトリ・データとその属性、およびスタイルやテーマなど、空間データをレンダリングする方法についてのメタデータ)が、ローカル・ファイルに保存されているためです。
カタログ・データ・ソースを作成および使用するための一般的なステップは、次のとおりです。
- Oracleデータベースからの必要なメタデータのエクスポート
- 必要な空間表のエクスポート
- カタログ・データ・ソースを追加するためのマップ・ビジュアライゼーション・コンポーネント構成ファイルの編集
- マップ・ビジュアライゼーション・コンポーネント・サーバーの再起動
親トピック: データソース
1.5.2.13.1.1.1 Oracleデータベースからの必要なメタデータのエクスポート
カタログ・データ・ソースを作成する前に、Map Builderを使用して、USER_SDO_CACHED_MAPS.xml
ファイル、USER_SDO_THEMES.xml
ファイル、およびU
SER_SDO_STYLES.xml
ファイルをエクスポートする必要があります。適用される考慮点は次のとおりです。
-
カタログ・データ・ソースでは、外部タイル・レイヤーのみがサポートされます。そのため、USER_SDO_CACHED_MAPS.xmlにエクスポートしたタイル層は、Oracle eLocationマップ・サービスなどの外部タイル層である必要があります。
-
USER_SDO_THEMES.xmlで必要になるすべてのスタイルが、USER_SDO_STYLES.xmlファイルにエクスポートされている必要があります。
-
エクスポートしたすべてのテーマで使用する必須の空間データ表のすべて(空間データをフェッチしたテーマの実表)をノートにとっておいて、それぞれの実表をGeoJSONファイル(「必要な空間表のエクスポート」を参照)にエクスポートできるようにする必要があります。
-
Map Builderユーティリティで、「ツール」、「メタデータをXMLにエクスポート」の順に選択します。
-
メタデータを保存するための一時ディレクトリを選択します。
-
表名のデフォルトの接頭辞(
USER_SDO_
)をそのまま使用します。 -
エクスポートするタイル・レイヤー、テーマ、およびスタイルを選択します。(目的のテーマに必要なスタイルが不明確な場合は、すべてのスタイルをエクスポートしてください)。
-
「OK」をクリックして、エクスポート操作を実行します。
指定したディレクトリに
USER_SDO_CACHED_MAPS.xml
ファイル、USER_SDO_THEMES.xml
ファイル、およびU
SER_SDO_STYLES.xml
ファイルが作成されます。
親トピック: カタログ・データ・ソース
1.5.2.13.1.1.2 必要な空間表のエクスポート
カタログ・データ・ソースの場合、空間データのセットはGeoJSONファイルに保存されています。1つのGeoJSONファイルは、データベース内の1つの空間表に対応します。空間表をエクスポートする場合は、マップ・ビジュアライゼーション・コンポーネント・サーバーにリクエストを送信します。
たとえば、OBIEE_COUNTRYという空間表がUSER_SDO_THEMES.xml
ファイル内のカタログ・データ・ソースのテーマで必要な場合は、この空間表を1つのGeoJSONファイルとしてエクスポートする必要があります(このテーマは、OBIEE_COUNTRYと呼ばれることがあると仮定します)。慣例として、これには空間表の名前と同じ名前を付けてください。この場合は、OBIEE_CONTRY.json
という名前を付けます。
-
USER_SDO_THEMES.xml
ファイルのテーマの定義を確認します。たとえば、OBIEE_COUNTRYという名前のテーマがOBIEE_COUNTRY空間表を使用している場合は、その空間表をエクスポートする必要があります。表の列と予測される名前は特定されている必要があり、列名はテーマ定義のname属性と同じになります。次の例では、ISO_COUNTRY_CODE列がCountry Code
としてマップされています。<theme> <name>OBIEE_COUNTRY</name> <description><![CDATA[OBIEE Country]]></description> <base_table>OBIEE_COUNTRY</base_table> <geometry_column>GEOMETRY</geometry_column> <styling_rules><![CDATA[<?xml version="1.0" standalone="yes"?><styling_rules> <hidden_info> <field column="ISO_COUNTRY_CODE" name="Country Code"/> <field column="NAME" name="Country Name"/> <field column="NAME_INIT" name="Country Name (Init)"/> </hidden_info> <rule> <features style="C.AIRPORTS"> </features> <label column="NAME_LABEL" style="T.COUNTRY_NAME_10"> 1 </label> </rule> </styling_rules>]]></styling_rules> </theme> . . .
-
空間表の列を特定します。次の例では、GEOMETRYという名前の空間ジオメトリ列が実表OBIEE_COUNTRYに含まれています。
SQL> describe obiee_country Name Null? Type ----------------------------- -------- ---------------------------- NAME VARCHAR2(255 CHAR) NAME_INIT VARCHAR2(1020 CHAR) OBIEE_LOWER VARCHAR2(1020 CHAR) ISO_COUNTRY_CODE VARCHAR2(5) SQKM NUMBER(11) NAME_LABEL VARCHAR2(255 CHAR) GEOMETRY MDSYS.SDO_GEOMETRY
-
マップ・ビジュアライゼーション・コンポーネント・データ・サーバーへのリクエスト文字列を作成します。たとえば、実表がOBIEE_COUNTRYであり、マップ・ビジュアライゼーション・コンポーネントが
localhost:8080
で実行しており、空間データの取得が有効化されているデータ・ソースの名前がmy_ds_name
である場合、次に示すようなリクエストを送信することになります。http://localhost:8080/ mapviewer/dataserver/my_ds_name?t=obiee_country&sql=select iso_country_code as id, iso_country_code as "country Code", name as "Country Name", name_init as "Country Name (Init)", name_label, geometry from obiee_country&id_col=id&simplify=true&threshold=90&include_label_box=true
データセットは、この例では
OBIEE_COUNTRY.json
という名前で一時フォルダに保存できます。この一時フォルダは、エクスポートしたメタデータ(USER_SDO_CACHED_MAPS.xml
ファイル、USER_SDO_THEMES.xml
ファイル、およびUSER_SDO_STYLES.xml
ファイル)が保存されているフォルダです。
親トピック: カタログ・データ・ソース
1.5.2.13.1.1.3 カタログ・データ・ソースを追加するためのマップ・ビジュアライゼーション・コンポーネント構成ファイルの編集
mapViewerConfig.xml
ファイルを編集して、カタログ・データ・ソースを追加します。次に例を示します。
<map_data_source name="catalogds1" catalog_dir="../catalogs/datafolder1" private="true" number_of_mappers="3" allow_jdbc_theme_based_foi="true" editable="false"/>
前述のカタログ・データ・ソース定義の場合は、mapViewerConfig.xml
ファイルが保存されている場所を基準として指定されるcatalog_dir
フォルダを作成して、そのフォルダにすべてのデータ・ファイルをコピーする必要があります。つまり、エクスポートした3つのメタデータ・ファイル(USER_SDO_CACHED_MAPS.xml
、USER_SDO_THEMES.xml
、およびUSER_SDO_STYLES.xml
)と、エクスポートしたすべてのGeoJSONファイル(この例では、OBIEE_COUNTRY.json
など)をコピーします。
親トピック: カタログ・データ・ソース
1.5.2.13.1.1.4 マップ・ビジュアライゼーション・コンポーネント・サーバーの再起動
マップ・ビジュアライゼーション・コンポーネント・サーバーを再起動します。
マップ・ビジュアライゼーション・コンポーネント・サーバーの再起動後、エクスポートしたすべてのタイル層とテーマに、このカタログ・データ・ソースからアクセスできるようになります。たとえば、次のようなマップ・リクエストを送信すると、マップ画像を確認できます。
http://localhost:8080/mapviewer/omserver?xml_request= <?xml version="1.0" standalone="yes"?> <map_request datasource = "catalogds1" width="1024" height="768" format="PNG_STREAM"> <center size="200"> <geoFeature><geometricProperty typeName="center"> <Point> <coordinates>0, 0</coordinates> </Point> </geometricProperty></geoFeature> </center> <themes> <theme name="OBIEE_COUNTRY"> </theme> </themes> </map_request>
親トピック: カタログ・データ・ソース
1.5.2.14 HTML5 API用のマップ・データ・サーバーの構成および保護
マップ・ビジュアライゼーション・コンポーネントでは、デフォルトでテーマをストリーミングできるようになっています。これらのテーマを保護するには、認証の追加が必要です。これを行うには、マップ・ビジュアライゼーション・コンポーネントのweb.xml
ファイルにセキュリティ制約を追加し、構成ファイルの<mds_config>
要素を構成して、テーマへのアクセスを認可します。
マップ・データ・サーバー(MDS)サーバー・コンポーネントにより、Oracle Maps APIへのベクトル形式の地理空間データのストリーミングが容易になります(「Oracle Maps JavaScript API」を参照)。MDSは、ブラウザ・クライアントがマップ・ビジュアライゼーション・コンポーネント・サーバー・インスタンスから任意の事前定義済または動的(JDBC)テーマのベクトル・データをリクエストするためのRESTful APIを提供します。このサービスへのアクセスをセキュアまたは保護するための唯一の方法は、マップ・ビジュアライゼーション・コンポーネントweb.xml
デプロイメント・ファイルにセキュリティ制約を追加することです。次に例を示します。
<security-constraint> <web-resource-collection> . . . <url-pattern>/dataserver/*</url-pattern> </web-resource-collection> <auth-constraint> <role-name>map_admin_role</role-name> </auth-constraint> </security-constraint>
この例は、相対パス/dataserver/
を持つすべての受信URLにセキュリティ制約を追加します。MDSサーブレットは、パスに/dataserver
が含まれているURLのみに応答するため、この制約はMDSへのすべてのアクセスを効果的に保護します。したがって、マップ・データ・サーバーにアクセスするすべてのアプリケーションまたはWebクライアントが適切な認証を要求され、map_admin_role
ロールを持つユーザーのみがアクセスを許可されます。(MDSなどのJava EEサーブレットを保護する方法の詳細は、Java EEおよびWebLogic Serverのドキュメントを参照してください。)
MDS URLパターンにセキュリティ制約を追加したかどうかにかかわらず、すべての事前定義済または動的(JDBC)テーマのベクトル・データへのアクセスはデフォルトでブロックされます。つまり、たとえば/dataserver/*
のURLが保護されており、HTML5アプリケーションが認証に成功した場合でも、適切な認可がないテーマのデータにアクセスできません。Oracle Maps HTML5アプリケーションが適切な認可のないテーマのロードまたは表示を試みると、「このデータソースはストリーミング・アクセスが許可されていません。」という内容を含む一般的なエラー・メッセージが表示されます。
データソースのテーマへのアクセスを許可するには、構成ファイルで明示的に<mds_config>
要素を構成する必要があります。
例1-2 mds.xmlファイルの構成
例1-2に<mds_config>
要素を示します。ここでは、2つのマップ・ビジュアライゼーション・コンポーネント・データソース、mvdemo
とmy-data
が特定のテーマをクライアントにストリームできるように構成されています。
<mds_config> <data_source name="mvdemo"> <allow_predefined_themes>true</allow_predefined_themes> <deny>my_secret_theme</deny> <allow_dynamic_themes>true</allow_dynamic_themes> </data_source> <data_source name="my-data"> <allow_predefined_themes>false</allow_predefined_themes> <allow> <theme>public_points_theme</theme> <theme>office_locations*</theme> </allow> <allow_dynamic_themes>false</allow_dynamic_themes> </data_source> </mds_config>
例1-2では、次のようになります。
-
各データソースは、独自の
<data_source>
要素内でそれぞれのテーマを認可します。この要素では、2つのタグ、<allow_predefined_themes>
および<allow_dynamic_themes>
が、この2つのテーマ・タイプへの全体的またはデフォルトのアクセス制御を提供します。動的(JDBC)テーマは、データソース定義内(メインmapViewerConfig.xml
ファイル)で無効にすることもできます。動的テーマがデータソース定義で無効になっている場合、その設定が常に優先されます(どのように、<mds_config>
要素に設定されているかは関係ありません)。 -
mvdemo
データソースでは、デフォルトですべてのクライアントが事前定義済テーマおよび動的(JDBC)テーマのベクトル・データにアクセスできます。これはデータの特性を考えると(一般公開されたサンプルからのデータ)、妥当な選択です。ただし、my_secret_theme
テーマには<deny>
タグが使用されており、例外になっています。 -
my-data
データソースでは、両方のテーマ・タイプへのアクセスがデフォルトでブロックされています。この場合は、<allow>
タグを使用して例外を追加します(ストリーミングのために特定のテーマを開く)。<allow>
タグおよび<deny>
タグでは、テーマの名前またはパターンは大文字と小文字が区別されません。また、ワイルド・カード文字*(アスタリスク)を使用して複数のテーマに一致させることができます。この例では<allow>
タグを使用して、public_points_theme
テーマおよび名前がoffice_locations
で始まるすべてのテーマをストリーミングのために開放していますが、他のすべてのテーマはブロックされています。このデータソースでは、動的(SQL)テーマは許可されません。
<mds_config>
要素を変更した場合は、デプロイされたマップ・ビジュアライゼーション・コンポーネント・インスタンスを再起動して、変更を有効にする必要があります。
親トピック: マップ・ビジュアライゼーション・コンポーネントの構成
1.5.3 JDBCコンテナを使用したマップ・ビジュアライゼーション・コンポーネント・データソースの作成
JDBCデータソースは、マップ・ビジュアライゼーション・コンポーネント構成ファイルのコンテナ定義データソースを使用して作成できます。ただし、新しく作成したコンテナ・データソースへのデータベース接続を確立するには、次の項の手順を実行した後にマップ・ビジュアライゼーション・コンポーネントを再起動する必要があります。
親トピック: マップ・ビジュアライゼーション・コンポーネントの管理
1.5.3.1 マップ・ビジュアライゼーション・コンポーネント・コンテナでのJDBCデータソースの作成
Oracle Enterprise Manager 12c以降を使用して、Oracle Databaseに接続するデータソースを作成できます。
次のステップに、GridLinkデータソースの作成方法を示します。(このステップの後にマルチ・データソースの作成方法を示します。)
-
Enterprise Managerにログインし、「ターゲット・ナビゲーション」ペインで、マップ・ビジュアライゼーション・コンポーネント・サーバーが含まれているサーバー・インスタンスをクリックします。
図1-2で、「WebLogicドメイン」下の「map_viewer1」をクリックすると、ウィンドウのメイン領域に
map_viewer1
のサーバー情報が表示されます。 -
図1-3に示すように、「WebLogic Server」をクリックし、「JDBCデータソース」を選択します。
-
図1-4に示すように、「JDBCデータソース」で「作成」をクリックして「GridLinkデータ・ソース」を選択します。
-
新規JDBCデータソースの作成ウィザードで、必要な情報を入力します。たとえば、
jdbc/mvdemo
というコンテナ・データソースを作成する場合は次のとおりです。-
データソース・プロパティ:データソース名には
mvdemo
、ドライバ・サービス名にはOracle Driver (Thin XA) for GridLink Connections Versions: Any
、JNDI名にはjdbc/mvdemo
と指定します。 -
接続プロパティ:適切なホストにデータベース・ユーザー
mvdemo
のURLを生成します。 -
トランザクション・プロパティ:表示されたトランザクション・プロパティを受け入れます。
-
ONSプロパティ:表示されたトランザクション・プロパティを受け入れるか、必要に応じて変更します。
-
ターゲットの選択:「名前」の下の
map_viewer1
を選択して目的のサーバーにJDBCデータソースをデプロイします。 -
確認:新規に作成するデータソースのプロパティを確認します。変更する必要がある場合は、戻って変更を加えてからこのページに戻ります。
-
前述のステップのようなGridLinkデータソースではなく、マルチ・データソースを作成するには、必要に応じてステップを変えてください。次に例を示します。
-
Enterprise Managerにログインし、「ターゲット・ナビゲーション」ペインで、マップ・ビジュアライゼーション・コンポーネント・サーバーが含まれているサーバー・インスタンスをクリックします。
図1-5で、「WebLogicドメイン」下の「map_viewer1」をクリックすると、ウィンドウのメイン領域に
map_viewer1
のサーバー情報が表示されます。 -
図1-6に示すように、「WebLogic Server」をクリックし、「JDBCデータソース」を選択します。
-
図1-7に示すように、「JDBCデータソース」で「作成」をクリックして「マルチ・データソース」を選択します。
-
必要な情報を入力します。次に例を示します。
-
データソース・プロパティ:データソース名には
mvdemo
、JNDI名にはjdbc/mvdemo
、アルゴリズム・タイプにはFailover
と指定します。 -
ターゲットの選択:「名前」の下の
map_viewer1
を選択します。 -
データソース・タイプの選択:デフォルト値を受け入れます(
non-XA Driver
)。 -
「新しいデータ・ソースの作成」をクリックします。
-
最初のデータソース・ノードのプロパティを指定します。例:名前は
mvdemo-rac0
、JNDI名はjdbc/mvdemo-rac0
、データベース・タイプはOracle
。 -
データベース・ドライバには、
Oracle's Driver (Thin) for Oracle RAC Service-Instance connections: Versions: Any
を選択します。 -
デフォルト値を受け入れます(
Supports Global Transactions
およびOne-Phase Commit
)。 -
ノード1の接続プロパティを定義します。サービス名、データベース名、ホスト名、ポート、データベース・ユーザー名、パスワードおよびプロトコルの値を入力します。
-
プロパティを確認し、「構成のテスト」をクリックします。成功した場合は、「次へ」をクリックします。
-
マップ・ビジュアライゼーション・コンポーネントのデプロイ先サーバー(
map_viewer1
)を選択(チェック)し、「終了」をクリックします。 -
次のページで、「新しいデータ・ソースの作成」をクリックして2番目のノードを作成および構成します。
-
2番目のデータソース・ノードのプロパティを指定します。例:名前は
mvdemo-rac1
、JNDI名はjdbc/mvdemo-rac1
、データベース・タイプはOracle
。 -
データベース・ドライバには、
Oracle's Driver (Thin) for Oracle RAC Service-Instance connections: Versions: Any
を選択します。 -
デフォルト値を受け入れます(
Supports Global Transactions
およびOne-Phase Commit
)。 -
ノード2の接続プロパティを定義します。サービス名、データベース名、ホスト名、ポート、データベース・ユーザー名、パスワードおよびプロトコルの値を入力します。
-
プロパティを確認し、「構成のテスト」をクリックします。成功した場合は、「次へ」をクリックします。
-
マップ・ビジュアライゼーション・コンポーネントのデプロイ先サーバー(
map_viewer1
)を選択(チェック)し、「終了」をクリックします。 -
ノードの追加が必要な場合は、「新しいデータ・ソースの作成」をクリックして、前述のような方法で各ノードを作成します。
-
1.5.3.2 マップ・ビジュアライゼーション・コンポーネント・データソースの作成
マップ・ビジュアライゼーション・コンポーネント・コンテナにコンテナ・データソースを作成した後(マップ・ビジュアライゼーション・コンポーネント・コンテナでのJDBCデータソースの作成を参照)、マップ・ビジュアライゼーション・コンポーネント・データソースにcontainer_ds
属性を追加して、Oracleデータベースへの接続が可能な新しいマップ・ビジュアライゼーション・コンポーネント・データソースを作成します。次に例を示します。
<map_data_source name="mvdemo"
container_ds="jdbc/mvdemo"
number_of_mappers="7" />
前述の例は、次のとおりです。
-
name
属性は、マップ・ビジュアライゼーション・コンポーネント・データソース名を指定します。これはマップ・リクエストのために必要です。 -
container_ds
属性の値は、新規JDBCデータソースの作成ウィザードの「データソース・プロパティ」ページで指定した「JNDI名」と一致している必要があります。 -
number_of_mappers
属性では、このデータソースをターゲットにできる、サポートされる同時マップ・リクエストの最大数を指定します。
これらの属性の詳細は、「永続マップ・データソースの定義」を参照してください。
1.5.4 Oracleサービス名を使用したマップ・ビジュアライゼーション・コンポーネント・データソースの作成
マップ・ビジュアライゼーション・コンポーネント構成ファイル(JDBCコンテナを使用したマップ・ビジュアライゼーション・コンポーネント・データソースの作成を参照)内のcontainer_ds
属性で使用するJDBCコンテナ・データソースを作成するかわりに、Oracle Database接続のパラメータを指定することで、マップ・ビジュアライゼーション・コンポーネント・データソースをマップ・ビジュアライゼーション・コンポーネント構成ファイルに直接作成できます。(この接続タイプは、Oracle Databaseリリース11.2以上でのみ使用できます。)次に例を示します。
<map_data_source name="mvdemo"
jdbc_host="hostname.example.com"
jdbc_sid="//srv.mycompany.com"
jdbc_port="1521"
jdbc_user="mvdemo"
jdbc_password="<password_for_mvdemo>"
jdbc_mode="thin"
number_of_mappers="8"
allow_jdbc_theme_based_foi="true"
editable="false"
/>
前述の例は、次のとおりです。
-
jdbc_host
属性は、Oracle IPアドレスまたはホスト名である必要があります。 -
jdbc_sid
属性は、SID値ではなく、Oracleデータベース・サービス名を指定します(jdbc_sid="//srv.mycompany.com"
の先頭の//
文字に注意)。
この例の属性の詳細は、「永続マップ・データソースの定義」を参照してください。
新しく作成したマップ・ビジュアライゼーション・コンポーネント・データソースを有効にするには、マップ・ビジュアライゼーション・コンポーネントを再起動する必要があります。再起動すると、マップ・ビジュアライゼーション・コンポーネントは接続パラメータを使用して必要なデータベース接続を直接取得します。
親トピック: マップ・ビジュアライゼーション・コンポーネントの管理
1.5.5 マップ・ビジュアライゼーション・コンポーネントの管理タスクの実行
マップ・ビジュアライゼーション・コンポーネントの構成方法の理解に加え、マップ・ビジュアライゼーション・コンポーネントの管理ページを使用して他の重要な管理タスクを実行する方法を理解する必要があります。このページへのログイン方法については、「マップ・ビジュアライゼーション・コンポーネントの「管理」ページへのログイン」を参照してください。
マップ・ビジュアライゼーション・コンポーネント管理者として実行できるタスクには、次のようなものがあります。
-
構成ファイルの編集
「構成」をクリックします。
-
データソースのリストのリフレッシュ
「管理」をクリックしてリストを自動的にリフレッシュするか、「リフレッシュ」をクリックして手動リフレッシュを実行します。
-
マップ・ビジュアライゼーション・コンポーネントのスタイル、テーマ、およびベース・マップのキャッシュされた定義のクリア
「管理」をクリックし、データソースを選択して、「キャッシュされたメタデータのパージ」をクリックします。
-
事前定義済テーマからのキャッシュされたジオメトリ・データのクリア
「管理」をクリックし、「ジオメトリ・キャッシュ」をクリックして、選択したテーマまたはすべてのテーマの「パージ」をクリックします。
-
Oracle Mapsのマップ・タイル層の作成
「管理」、「タイル・レイヤーの作成」の順にクリックし、タイル層のタイプを選択して、「次」をクリックします。
「Internal」マップ・ソース: マップ・キャッシュ名を入力した後、データソースとベース・マップを選択します。また、キャッシュ記憶域(タイルの格納先)、ズーム・レベル、最小および最大スケール、空間参照ID (SRID)、データ枠ボックス(MBR)、およびタイルのサイズと形式のパラメータも定義します。「次」をクリックし、「送信」をクリックして、マップ・タイル層を作成します。また、「XML」をクリックし、XMLでマップ・キャッシュ・プロパティを定義することもできます。
「External」マップ・ソース: マップ・キャッシュ名を入力した後、データソースを選択します。外部ソースにアクセスするには、マップ・サービスURL、リクエスト・メソッド(GETまたはPOST)、プロキシ情報(必要な場合)、サーバー上のJavaアダプタ・クラス名とその位置、アダプタのその他のプロパティなどのパラメータを定義します。また、キャッシュ記憶域(タイルの格納先)、ズーム・レベル、最小および最大スケール、空間参照ID (SRID)、データ枠ボックス(MBR)、およびタイルのサイズと形式のパラメータも定義します。「次」をクリックし、「送信」をクリックして、マップ・タイル層を作成します。また、「XML」をクリックし、XMLでマップ・キャッシュ・プロパティを定義することもできます。
その他のタイプのタイル層(Oracle Maps、Here、Google、TomTom)についても、同様のステップを実行してください。
-
Oracle Mapsのマップ・タイル層の管理
「管理」をクリックして、「タイル・レイヤーの管理」をクリックします。その後、次のいずれかの操作を実行します。
タイル層のリストを手動でリフレッシュする場合は、「リフレッシュ」をクリックします。
マップ・タイル層を編集するには、その層の行を選択して、「詳細の編集/表示」をクリックします。
マップ・タイル層を表示および管理するには、その層の行を選択して、「マップの表示/タイルの管理」をクリックします。
親トピック: マップ・ビジュアライゼーション・コンポーネントの管理