PostGIS - en to ja translation catalogue (288 entries)

note: Tag: title
en: PostGIS Installation
ja: PostGISインストール

note: Tag: para
en: This chapter details the steps required to install PostGIS.
ja: 本章では、PostGISのインストールに必要な手順について説明します。

note: Tag: title
en: Short Version
ja: 簡略版

note: Tag: para
en: To compile assuming you have all the dependencies in your search path:
ja: 全ての依存がパスに入っているとする場合、次のようにコンパイルします。

note: Tag: para
en: Once postgis is installed, it needs to be enabled in each individual database you want to use it in.
ja: PostGISをインストールした後は、利用したいデータベース個々内で利用可能にする必要があります。

note: Tag: para
en: The raster support is currently optional, but installed by default. For enabling using the PostgreSQL 9.1+ extensions model raster is required. Using the extension enable process is preferred and more user-friendly. To spatially enable your database:
ja: ラスタ機能は現在はオプションですが、デフォルトではインストールされます。PostgreSQL 9.1以上のエクステンションモデルを使ってインストールするには必須です。エクステンションを有効にする処理の方がよりよく、かつユーザフレンドリです。空間データベースを有効にするには、次のようにします。

note: Tag: programlisting
en: psql -d yourdatabase -c "CREATE EXTENSION postgis;"
    psql -d yourdatabase -c "CREATE EXTENSION postgis_topology;"
    -- if you built with sfcgal support --
    psql -d yourdatabase -c "CREATE EXTENSION postgis_sfcgal;"
    
    -- if you want to install tiger geocoder --
    psql -d yourdatabase -c "CREATE EXTENSION fuzzystrmatch"
    psql -d yourdatabase -c "CREATE EXTENSION postgis_tiger_geocoder;"
    
    -- if you installed with pcre
    -- you should have address standardizer extension as well
    psql -d yourdatabase -c "CREATE EXTENSION address_standardizer;"
ja: psql -d yourdatabase -c "CREATE EXTENSION postgis;"
    psql -d yourdatabase -c "CREATE EXTENSION postgis_topology;"
    -- SFCGAL対応でビルドした場合は次を実行 --
    psql -d yourdatabase -c "CREATE EXTENSION postgis_sfcgal;"
    
    -- Tigerジオコーダをインストールしたい場合は次の二つを実行 --
    psql -d yourdatabase -c "CREATE EXTENSION fuzzystrmatch"
    psql -d yourdatabase -c "CREATE EXTENSION postgis_tiger_geocoder;"
    
    -- PCRE付きでインストールした場合は
    -- 住所標準化エクステンションも持つべきです
    psql -d yourdatabase -c "CREATE EXTENSION address_standardizer;"

note: Tag: para
en: Please refer to <xref linkend="make_install_postgis_extensions"/> for more details about querying installed/available extensions and upgrading extensions, or switching from a non-extension install to an extension install.
ja: インストールされて有効になっているEXTENSIONのクエリやEXTENSIONのアップグレード、EXTENSIONを使わずにインストールした場合のEXTENSIONへの切り替えに関する詳細情報については、<xref linkend="make_install_postgis_extensions"/>を参照して下さい。

note: Tag: para
en: For those running who decided for some reason not to compile with raster support, or just are old-fashioned, here are longer more painful instructions for you:
ja: なんらかの理由で、ラスタ機能なしでコンパイルするか古いやり方でインストールする場合には、より長く、より苦痛を伴いますが、やり方はあります。

note: Tag: para
en: All the .sql files once installed will be installed in share/contrib/postgis-&last_minor_version; folder of your PostgreSQL install
ja: インストールされた.sqlファイルは全てPostgreSQLがインストールされているフォルダ内のshare/contrib/postgis-&last_minor_version;の中にあります。

note: Tag: programlisting
en: createdb yourdatabase
    createlang plpgsql yourdatabase
    psql -d yourdatabase -f postgis.sql
    psql -d yourdatabase -f postgis_comments.sql
    psql -d yourdatabase -f spatial_ref_sys.sql
    psql -d yourdatabase -f topology.sql
    psql -d yourdatabase -f topology_comments.sql
    
    -- only if you compiled with raster (GDAL)
    psql -d yourdatabase -f rtpostgis.sql
    psql -d yourdatabase -f raster_comments.sql
    
    --if you built with sfcgal support --
    psql -d yourdatabase -f sfcgal.sql
    psql -d yourdatabase -f sfcgal_comments.sql
ja: createdb yourdatabase
    createlang plpgsql yourdatabase
    psql -d yourdatabase -f postgis.sql
    psql -d yourdatabase -f postgis_comments.sql
    psql -d yourdatabase -f spatial_ref_sys.sql
    psql -d yourdatabase -f topology.sql
    psql -d yourdatabase -f topology_comments.sql
    
    -- raster (GDAL)付きでコンパイルした場合のみ
    psql -d yourdatabase -f rtpostgis.sql
    psql -d yourdatabase -f raster_comments.sql
    
    -- SFCGAL対応でビルドした場合 --
    psql -d yourdatabase -f sfcgal.sql
    psql -d yourdatabase -f sfcgal_comments.sql

note: Tag: para
en: The rest of this chapter goes into detail each of the above installation steps.
ja: 本章の残りでは、上記のインストール手順の個々の詳細を見ていきます。

note: Tag: para
en: As of PostGIS 2.1.3, out-of-db rasters and all raster drivers are disabled by default. In order to re-enable these, you need to set the following environment variables <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> and <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> in the server environment. For PostGIS 2.2, you can use the more cross-platform approach of setting the corresponding <xref linkend="PostGIS_GUC"/>.
ja: PostGIS 2.1.3では、データベース外ラスタと全てのラスタドライバは、デフォルトでは無効になっています。これらを有効にするには、サーバ上で、環境変数<varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname>と<varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname>を設定します。PostGIS 2.2では、<xref linkend="PostGIS_GUC"/>に従って設定する、クロスプラットフォームな手法があります。

note: Tag: para
en: If you want to enable offline raster:
ja: データベース外ラスタを有効にするには次のようにします。

note: Tag: para
en: Any other setting or no setting at all will disable out of db rasters.
ja: 他の値を入れたり、値を入れない場合には、データベース外ラスタは無効になります。

note: Tag: para
en: In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows
ja: インストールしたGDALのドライバを有効にするには、次の環境変数を設定します。

note: Tag: para
en: If you want to only enable specific drivers, set your environment variable as follows:
ja: 一部のドライバのみ有効にしたい場合には、環境変数を次のように設定します。

note: Tag: para
en: If you are on windows, do not quote the driver list
ja: Windows上の場合は、ドライバリストに引用符をつけないで下さい。

note: Tag: para
en: Setting environment variables varies depending on OS. For PostgreSQL installed on Ubuntu or Debian via apt-postgresql, the preferred way is to edit <filename>/etc/postgresql/<replaceable>10</replaceable>/<replaceable>main</replaceable>/environment</filename> where 9.3 refers to version of PostgreSQL and main refers to the cluster.
ja: 環境変数の設定はOSによって変わります。UbuntuやDebian上でapt-postgresqlからインストールしたPostgreSQLの場合には、<filename>/etc/postgresql/<replaceable>10</replaceable>/<replaceable>main</replaceable>/environment</filename>を編集するのが好まれます。なお、10はPostgreSQLの版を指し、mainはクラスタを示します。

note: Tag: para
en: On windows, if you are running as a service, you can set via System variables which for Windows 7 you can get to by right-clicking on Computer-&gt;Properties Advanced System Settings or in explorer navigating to <varname>Control Panel\All Control Panel Items\System</varname>. Then clicking <emphasis>Advanced System Settings -&gt;Advanced->Environment Variables</emphasis> and adding new system variables.
ja: Windowsでサービスとして実行している場合には、システム変数で設定します。Windows 7では、コンピュータを右クリックしてプロパティをクリックするか、エクスプローラの検索バーに<varname>コントロール パネル\すべてのコントロール パネル項目\システム</varname>を指定します。<emphasis>システムの詳細設定 -&gt; 詳細設定 -&gt; 環境変数</emphasis>を順にクリックして、新しいシステム環境変数を追加します。

note: Tag: para
en: After you set the environment variables, you'll need to restart your PostgreSQL service for the changes to take effect.
ja: 環境変数を設定した後は、設定を反映させるために、PostgreSQLサービスの再起動が必要です。

note: Tag: title
en: Install Requirements
ja: インストール要件

note: Tag: para
en: PostGIS has the following requirements for building and usage:
ja: PostGISのビルドと利用のために、次のものが必要です。

note: Tag: emphasis
en: Required
ja: 必須

note: Tag: para
en: PostgreSQL &min_postgres_version; or higher. A complete installation of PostgreSQL (including server headers) is required. PostgreSQL is available from <ulink url="http://www.postgresql.org"> http://www.postgresql.org </ulink> .
ja: PostgreSQL &min_postgres_version;以上。PostgreSQLの完全なインストール (サーバヘッダを含む)が必要です。PostgreSQLは<ulink url="http://www.postgresql.org/"> http://www.postgresql.org/</ulink>にあります。

note: Tag: para
en: For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support matrix refer to <ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</ulink>
ja: 完全なPosgreSQL/PostGIS対応表とPostGIS/GEOS対応表については<ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</ulink>をご覧ください。

note: Tag: para
en: GNU C compiler (<filename>gcc</filename>). Some other ANSI C compilers can be used to compile PostGIS, but we find far fewer problems when compiling with <filename>gcc</filename>.
ja: GNU Cコンパイラ (<filename>gcc</filename>)。ANSI Cコンパイラの中には、PostGISをコンパイルできるものもありますが、<filename>gcc</filename>でコンパイルするのが最も問題が少ないと見ています。

note: Tag: para
en: GNU Make (<filename>gmake</filename> or <filename>make</filename>). For many systems, GNU <filename>make</filename> is the default version of make. Check the version by invoking <filename>make -v</filename>. Other versions of <filename>make</filename> may not process the PostGIS <filename>Makefile</filename> properly.
ja: GNU Make (<filename>gmake</filename>または<filename>make</filename>)。多くのシステムで、GNU makeがデフォルトのmakeになっています。<filename>make -v</filename>を実行して版を確認して下さい。他版の<filename>make</filename>では、PostGISの<filename>Makefile</filename>を完全に処理しきれないかもしれません。

note: Tag: para
en: Proj4 reprojection library, version 4.9.0 or greater. Proj4 4.9 or above is needed to take advantage of improved geodetic. The Proj4 library is used to provide coordinate reprojection support within PostGIS. Proj4 is available for download from <ulink url="http://trac.osgeo.org/proj/"> http://trac.osgeo.org/proj/ </ulink> .
ja: 投影変換ライブラリ Proj4 の 4.9.0版以上。地理座標系の改善の利点を得るには、Proj4 4.9以上が必要です。Proj4ライブラリは、PostGISの座標系投影変換機能に使われます。Proj4は、<ulink url="http://trac.osgeo.org/proj/">http://trac.osgeo.org/proj/</ulink>からダウンロードできます。

note: Tag: para
en: GEOS geometry library, version 3.5 or greater, but GEOS 3.7+ is recommended to take full advantage of all the new functions and features. You should have at least GEOS 3.5, without which you will be missing some major enhancements such as <xref linkend="ST_ClipByBox2D"/> and <xref linkend="ST_Subdivide"/>. GEOS is available for download from <ulink url="http://trac.osgeo.org/geos/"> http://trac.osgeo.org/geos/ </ulink> and 3.5+ is backward-compatible with older versions so fairly safe to upgrade.
ja: ジオメトリライブラリGEOSの3.５版以上。新しい関数や機能の全てを得るために、GEOS 3.7以上を推奨します。少なくともGEOS 3.5は持つべきで、<xref linkend="ST_ClipByBox2D"/>や<xref linkend="ST_Subdivide"/>のような機能強化が使えません。GEOSは<ulink url="http://trac.osgeo.org/geos/">http://trac.osgeo.org/geos/</ulink>からダウンロードできます。3.5以上は古い版との後方互換があり、アップグレードがかなり安全です。

note: Tag: para
en: LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports functions (ST_GeomFromGML and ST_GeomFromKML). LibXML2 is available for download from <ulink url="http://xmlsoft.org/downloads.html">http://xmlsoft.org/downloads.html</ulink>.
ja: LibXML2の2.5.x以上。LibXML2は現在取り込み関数 (ST_GeomFromGMLとST_GeomFromKML)で使っています。LibXML2は<ulink url="http://xmlsoft.org/downloads.html">http://xmlsoft.org/downloads.html</ulink>からダウンロード可能です。

note: Tag: para
en: JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON via the function ST_GeomFromGeoJson. JSON-C is available for download from <ulink url="https://github.com/json-c/json-c/releases">https://github.com/json-c/json-c/releases/</ulink>.
ja: JSON-C 0.9以上。JSON-Cは現在、ST_GeomFromGeoJsonによるGeoJSONの取り込みに使われます。JSON-Cは<ulink url="https://github.com/json-c/json-c/releases/">https://github.com/json-c/json-c/releases/</ulink>からダウンロード可能です。

note: Tag: para
en: GDAL, version 1.8 or higher (1.9 or higher is strongly recommended since some things will not work well or behavior differently with lower versions). This is required for raster support and to be able to install with <code>CREATE EXTENSION postgis</code> so highly recommended for those running 9.1+. <ulink url="http://trac.osgeo.org/gdal/wiki/DownloadSource">http://trac.osgeo.org/gdal/wiki/DownloadSource</ulink>.
ja: GDAL 1.8以上 (古い版では一部機能が働かなかったり挙動が異なるので1.9以上を強く推奨します)。ラスタ機能に必要で、<code>CREATE EXTENSION postgis</code>でのインストールに必要となります。このため、PostgreSQL 9.1以上での使用では非常に推奨されます<ulink url="http://trac.osgeo.org/gdal/wiki/DownloadSource/">http://trac.osgeo.org/gdal/wiki/DownloadSource/</ulink>からダウンロード可能です。

note: Tag: emphasis
en: Optional
ja: オプション

note: Tag: para
en: GDAL (pseudo optional) only if you don't want raster and don't care about installing with <code>CREATE EXTENSION postgis</code> can you leave it out. Keep in mind other extensions may have a requires postgis extension which will prevent you from installing them unless you install postgis as an extension. So it is highly recommended you compile with GDAL support.
ja: GDAL (実質必須)。ラスタを求めておらず、かつ<code>CREATE EXTENSION postgis</code>によるインストールを気にしない場合に限って放置できます。他のEXTENSIONで、PostGISをEXTENSIONとしてインストールしないと、インストールできないものがあるかも知れないことを心にとどめておいて下さい。このため、GDAL対応でのコンパイルは、非常に望まれます。

note: Tag: para
en: Also make sure to enable the drivers you want to use as described in <xref linkend="install_short_version"/>.
ja: ドライバを有効にするには<xref linkend="install_short_version"/>を参照してください。

note: Tag: para
en: GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. <ulink url="http://www.gtk.org/"> http://www.gtk.org/ </ulink> .
ja: GTK (GTK+2.0, 2.8+が必要)。シェープファイルのローダであるshp2pgsql-guiのコンパイル用です。<ulink url="http://www.gtk.org/">http://www.gtk.org/</ulink>にあります。

note: Tag: para
en: SFCGAL, version 1.1 (or higher) could be used to provide additional 2D and 3D advanced analysis functions to PostGIS cf <xref linkend="reference_sfcgal"/>. And also allow to use SFCGAL rather than GEOS for some 2D functions provided by both backends (like ST_Intersection or ST_Area, for instance). A PostgreSQL configuration variable <code>postgis.backend</code> allow end user to control which backend he want to use if SFCGAL is installed (GEOS by default). Nota: SFCGAL 1.2 require at least CGAL 4.3 and Boost 1.54 (cf: <ulink url="http://oslandia.github.io/SFCGAL/installation.html">http://oslandia.github.io/SFCGAL/installation.html</ulink>) <ulink url="https://github.com/Oslandia/SFCGAL">https://github.com/Oslandia/SFCGAL</ulink>.
ja: SFCGAL 1.1版以上。追加的な2次元や3次元の高度な解析関数をPostGISで使うために使用するものです。<xref linkend="reference_sfcgal"/>をご覧下さい。また、GEOSを使う2次元関数のうちいくつか (たとえばST_IntersectionやST_Area)は、GEOSでなくSFCGALを使用することができます。PostgreSQLコンフィギュレーション変数<code>postgis.backend</code>によって、SFCGALがインストールされている場合にはエンドユーザがバックエンドを制御することができます (デフォルトではGEOS)。SFCGAL 1.2は少なくともCGAL 4.3とBoost 1.54 (<ulink url="http://oslandia.github.io/SFCGAL/installation.html">http://oslandia.github.io/SFCGAL/installation.html</ulink>をご覧下さい)が必要ですのでご注意下さい。<ulink url="https://github.com/Oslandia/SFCGAL">https://github.com/Oslandia/SFCGAL</ulink>にあります。

note: Tag: para
en: In order to build the <xref linkend="Address_Standardizer"/> you will also need PCRE <ulink url="http://www.pcre.org">http://www.pcre.org</ulink> (which generally is already installed on nix systems). <code>Regex::Assemble</code> perl CPAN package is only needed if you want to rebuild the data encoded in <filename>parseaddress-stcities.h</filename>. <xref linkend="Address_Standardizer"/> will automatically be built if it detects a PCRE library, or you pass in a valid <varname>--with-pcre-dir=/path/to/pcre</varname> during configure.
ja: <xref linkend="Address_Standardizer"/>をビルドするには、PCRE <ulink url="http://www.pcre.org">http://www.pcre.org</ulink> (Unix系システムには通常はインストール済みです)も必要です。<filename>parseaddress-stcities.h</filename>内のエンコードしたデータを再構築したい場合には、Perl CPANの<code>Regex::Assemble</code>パッケージのみ必要です。<xref linkend="Address_Standardizer"/>は、PCREライブラリを検出するか、コンフィギュレーションで適切に<varname>--with-pcre-dir=/path/to/pcre</varname>を指定すると、自動的にビルドされます。

note: Tag: para
en: To enable ST_AsMVT protobuf-c library (for usage) and the protoc-c compiler (for building) are required. Also, pkg-config is required to verify the correct minimum version of protobuf-c. See <ulink url="https://github.com/protobuf-c/protobuf-c">protobuf-c</ulink>.
ja: ST_AsMVTを有効にするには、protobuf-cライブラリ (実行時)とprotoc-cコンパイラ (ビルド時)が必要です。protobuf-cの正しい最小版を確認するには、pkg-configが必要です。<ulink url="https://github.com/protobuf-c/protobuf-c">protobuf-c</ulink>をご覧下さい。

note: Tag: para
en: CUnit (<filename>CUnit</filename>). This is needed for regression testing. <ulink url="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</ulink>
ja: CUnit (<filename>CUnit</filename>)。レグレッションテストに必要です。<ulink url="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</ulink>にあります。

note: Tag: para
en: DocBook (<filename>xsltproc</filename>) is required for building the documentation. Docbook is available from <ulink url="http://www.docbook.org/"> http://www.docbook.org/ </ulink> .
ja: DocBook (<filename>xsltproc</filename>)。文書のビルドに必要です。<ulink url="http://www.docbook.org/">http://www.docbook.org/</ulink>にあります。

note: Tag: para
en: DBLatex (<filename>dblatex</filename>) is required for building the documentation in PDF format. DBLatex is available from <ulink url="http://dblatex.sourceforge.net/"> http://dblatex.sourceforge.net/ </ulink> .
ja: DBLatex (<filename>dblatex</filename>)。文書をPDFでビルドするのに必要です。<ulink url="http://dblatex.sourceforge.net/">http://dblatex.sourcforge.net/</ulink>にあります。

note: Tag: para
en: ImageMagick (<filename>convert</filename>) is required to generate the images used in the documentation. ImageMagick is available from <ulink url="http://www.imagemagick.org/"> http://www.imagemagick.org/ </ulink> .
ja: ImageMagick (<filename>convert</filename>)。文書で使う画像を生成するのに必要です。<ulink url="http://www.imagemagick.org/">http://www.imagemagick.org/</ulink>にあります。

note: Tag: title
en: Getting the Source
ja: ソースの取得

note: Tag: para
en: Retrieve the PostGIS source archive from the downloads website <ulink url="&postgis_download_url;"> &postgis_download_url; </ulink>
ja: ダウンロードサイト<ulink url="&postgis_download_url;">&postgis_download_url;</ulink>からソースのアーカイブを入手します。

note: Tag: para
en: This will create a directory called <varname>postgis-&last_release_version;</varname> in the current working directory.
ja: これで、カレントディレクトリの下に<varname>postgis-&last_release_version;</varname>ができます。

note: Tag: para
en: Alternatively, checkout the source from the <ulink url="http://subversion.apache.org/"> svn </ulink> repository <ulink url="http://svn.osgeo.org/postgis/trunk/"> http://svn.osgeo.org/postgis/trunk/ </ulink> .
ja: もしくは<ulink url="http://subversion.apache.org/">svn</ulink>レポジトリ<ulink url="http://svn.osgeo.org/postgis/trunk/">http://svn.osgeo.org/postgis/trunk/</ulink>からチェックアウトします。

note: Tag: para
en: Change into the newly created <varname>postgis-&last_release_version;</varname> directory to continue the installation.
ja: 新しく作られた<varname>postgis-&last_release_version;</varname>ディレクトトリに移動して、インストールを続けます。

note: Tag: title
en: Compiling and Install from Source: Detailed
ja: ソースからのコンパイルとインストール: 詳細

note: Tag: para
en: Many OS systems now include pre-built packages for PostgreSQL/PostGIS. In many cases compilation is only necessary if you want the most bleeding edge versions or you are a package maintainer.
ja: 多くのOSで、ビルドされたPostgreSQL/PostGISパッケージがあります。多くの場合、コンパイルが必要なのは、最もひどい最先端の版が欲しい場合やパッケージメンテナンスを行う人ぐらいです。

note: Tag: para
en: This section includes general compilation instructions, if you are compiling for Windows etc or another OS, you may find additional more detailed help at <ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</ulink> and <ulink url="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</ulink>.
ja: 本節では、一般的なコンパイル手順を示します。Windows用や他のOS用等にコンパイルするなら、<ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</ulink>や<ulink url="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</ulink>で、より詳細な助けが見つかるかも知れません。

note: Tag: para
en: Pre-Built Packages for various OS are listed in <ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiPackages">PostGIS Pre-built Packages</ulink>
ja: 多くのOS用のビルド済みパッケージの一覧は<ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiPackages">PostGIS Pre-built Packages</ulink>にあります。

note: Tag: para
en: If you are a windows user, you can get stable builds via Stackbuilder or <ulink url="http://www.postgis.org/download/windows/">PostGIS Windows download site</ulink> We also have <ulink url="http://www.postgis.org/download/windows/experimental.php">very bleeding-edge windows experimental builds</ulink> that are built usually once or twice a week or whenever anything exciting happens. You can use these to experiment with the in progress releases of PostGIS
ja: Windowsユーザの場合は、スタックビルダか、<ulink url="http://www.postgis.org/download/windows/">PostGIS Windows download site</ulink>から安定版を得ることができます。また、週に1回か2回、刺激的なことがあれば随時ビルドを行っている<ulink url="http://www.postgis.org/download/windows/experimental.php">very bleeding-edge windows experimental builds</ulink>もあります。これらはPostGISの進行中のリリースでの試験に使用します。

note: Tag: para
en: The PostGIS module is an extension to the PostgreSQL backend server. As such, PostGIS &last_release_version; <emphasis>requires</emphasis> full PostgreSQL server headers access in order to compile. It can be built against PostgreSQL versions &min_postgres_version; or higher. Earlier versions of PostgreSQL are <emphasis>not</emphasis> supported.
ja: PostGISモジュールは、PostgreSQLバックエンドサーバの拡張です。PostGIS &last_release_version;では、コンパイルのために、完全なPostgreSQLサーバヘッダが<emphasis>必要です</emphasis>。PostgreSQL &last_release_version;以上でビルドできます。古い版のPostgreSQLは<emphasis>サポートされません</emphasis>。

note: Tag: para
en: Refer to the PostgreSQL installation guides if you haven't already installed PostgreSQL. <ulink url="http://www.postgresql.org"> http://www.postgresql.org </ulink> .
ja: PostgreSQLをインストールしていないならPostgreSQLインストールガイドを参照して下さい。<ulink url="http://www.postgresql.org/">http://www.postgresql.org/</ulink>にあります。

note: Tag: para
en: For GEOS functionality, when you install PostgresSQL you may need to explicitly link PostgreSQL against the standard C++ library:
ja: GEOS機能を有効にするために、PostgreSQLをインストール時に明示的に標準C++ライブラリに対する明示的なリンクが必要になる場合があります。

note: Tag: programlisting
en: LDFLAGS=-lstdc++ ./configure [YOUR OPTIONS HERE]
ja: LDFLAGS=-lstdc++ ./configure [コンフィギュアオプション]

note: Tag: para
en: This is a workaround for bogus C++ exceptions interaction with older development tools. If you experience weird problems (backend unexpectedly closed or similar things) try this trick. This will require recompiling your PostgreSQL from scratch, of course.
ja: これは、古い開発ツールとインチキC++例外との対話のための応急処置です。怪しい問題 (望んでいないのにバックエンドが閉じたりそれに近い挙動を起こす)を経験したなら、このトリックを試してみて下さい。もちろん、これを行うにはPostgreSQLをはじめからコンパイルし直す必要があります。

note: Tag: para
en: The following steps outline the configuration and compilation of the PostGIS source. They are written for Linux users and will not work on Windows or Mac.
ja: 次のステップでは、PostGISソースのコンフィギュレーションとコンパイルに概要を記述します。これらは、Linuxユーザ用に書いてありますので、WindowsやMacでは動作しません。

note: Tag: title
en: Configuration
ja: コンフィギュレーション

note: Tag: para
en: As with most linux installations, the first step is to generate the Makefile that will be used to build the source code. This is done by running the shell script
ja: ほとんどのLinuxのインストールと同様に、最初のステップでは、ソースコードのビルドに使われるMakefileを生成します。これは、シェルスクリプトが行います。

note: Tag: para
en: With no additional parameters, this command will attempt to automatically locate the required components and libraries needed to build the PostGIS source code on your system. Although this is the most common usage of <command>./configure</command>, the script accepts several parameters for those who have the required libraries and programs in non-standard locations.
ja: パラメータを付けない場合には、このコマンドは自動で、PostGISのソースコードのビルドを行うのに必要なコンポーネントやライブラリをシステム上で探します。<command>./configure</command>とするのが一般的な使い方ですが、標準的でない位置に必要なライブラリやプログラムを置いてある場合のために、いくつかのパラメータを受け付けます。

note: Tag: para
en: The following list shows only the most commonly used parameters. For a complete list, use the <command>--help</command> or <command>--help=short</command> parameters.
ja: 次のリストで、共通して使われるパラメータを示します。 完全なリストについては、<command>--help</command>または<command>--help=short</command>パラメータを使って下さい。

note: Tag: para
en: This is the location the PostGIS libraries and SQL scripts will be installed to. By default, this location is the same as the detected PostgreSQL installation.
ja: PostGISライブラリとSQLスクリプトのインストール先を指定します。デフォルトでは、検出されたPostgreSQLのインストール先と同じになります。

note: Tag: para
en: This parameter is currently broken, as the package will only install into the PostgreSQL installation directory. Visit <ulink url="http://trac.osgeo.org/postgis/ticket/635"> http://trac.osgeo.org/postgis/ticket/635 </ulink> to track this bug.
ja: このパラメータは現在のところ壊れていて、PostgreSQLのインストール先にしかインストールされません。このバグのトラックについては<ulink url="http://trac.osgeo.org/postgis/ticket/635">http://trac.osgeo.org/postgis/ticket/635</ulink>をご覧ください。

note: Tag: para
en: PostgreSQL provides a utility called <command>pg_config</command> to enable extensions like PostGIS to locate the PostgreSQL installation directory. Use this parameter (<command>--with-pgconfig=/path/to/pg_config</command>) to manually specify a particular PostgreSQL installation that PostGIS will build against.
ja: PostgreSQLは、PostGISなどの拡張に対してPostgreSQLのインストール先ディレクトリを伝える<command>pg_config</command>というユーティリティを持っています。PostGISの対象とする特定のPostgreSQLのインストール先を手動で指定する場合に、このパラメータ(<command>--with-pgconfig=/path/to/pg_config</command>)を使います。

note: Tag: para
en: GDAL, a required library, provides functionality needed for raster support <command>gdal-config</command> to enable software installations to locate the GDAL installation directory. Use this parameter (<command>--with-gdalconfig=/path/to/gdal-config</command>) to manually specify a particular GDAL installation that PostGIS will build against.
ja: 必須ライブラリであるGDALは、ラスタ機能に必要な機能を提供します。GDALには、インストール先ディレクトリをインストールスクリプトに伝える<command>gdal-config</command>があります。PostGISのビルドに使う特定のGDALを手動で指定する場合に、このパラメータ (<command>--with-gdalconfig=/path/to/gdal-config</command>)を使います。

note: Tag: para
en: GEOS, a required geometry library, provides a utility called <command>geos-config</command> to enable software installations to locate the GEOS installation directory. Use this parameter (<command>--with-geosconfig=/path/to/geos-config</command>) to manually specify a particular GEOS installation that PostGIS will build against.
ja: 必須のジオメトリライブラリであるGEOSには、ソフトウェアのインストール時にGEOSのインストール先ディレクトリを伝える<command>geos-config</command>というユーティリティがあります。PostGISのビルドに使う特定のGEOSを手動で指定する場合に、このパラメータ (<command>--with-geosconfig=/path/to/geos-config</command>)を使います。

note: Tag: para
en: LibXML is the library required for doing GeomFromKML/GML processes. It normally is found if you have libxml installed, but if not or you want a specific version used, you'll need to point PostGIS at a specific <filename>xml2-config</filename> confi file to enable software installations to locate the LibXML installation directory. Use this parameter (<command>>--with-xml2config=/path/to/xml2-config</command>) to manually specify a particular LibXML installation that PostGIS will build against.
ja: LibXMLはGeomFromKML/GML処理を行うのに必須のライブラリです。通常はlibxmlをインストールしているなら発見されますが、発見できない場合や特定の版を使用したい場合は、<filename>xml2-config</filename>を指定してインストールスクリプトにLibXMLのインストール先ディレクトリを伝えます。PostGISのビルドに使う特定のLibXMLを手動で指定する場合に、このパラメータ (<command>>--with-xml2config=/path/to/xml2-config</command>)を使います。

note: Tag: para
en: Proj4 is a reprojection library required by PostGIS. Use this parameter (<command>--with-projdir=/path/to/projdir</command>) to manually specify a particular Proj4 installation directory that PostGIS will build against.
ja: Proj4はPostGISに必須の投影変換ライブラリです。PostGISのビルドに使う特定のProj4のディレクトリを手動で指定する場合は、このパラメータ (<command>--with-projdir=/path/to/projdir</command>)を使います。

note: Tag: para
en: Directory where iconv is installed.
ja: iconvのインストール先ディレクトリを指定します。

note: Tag: para
en: <ulink url="http://oss.metaparadigm.com/json-c/">JSON-C</ulink> is an MIT-licensed JSON library required by PostGIS ST_GeomFromJSON support. Use this parameter (<command>--with-jsondir=/path/to/jsondir</command>) to manually specify a particular JSON-C installation directory that PostGIS will build against.
ja: <ulink url="http://oss.metaparadigm.com/json-c/">JSON-C</ulink>は、MITライセンスのJSONライブラリで、PostGISのST_GeomFromJSONに必須です。PostGISのビルドに使う特定のJSON-Cを手動で指定する場合に、このパラメータ (<command>--with-jsondir=/path/to/jsondir</command>)を使います。

note: Tag: para
en: <ulink url="http://www.pcre.org/">PCRE</ulink> is an BSD-licensed Perl Compatible Regular Expression library required by address_standardizer extension. Use this parameter (<command>--with-pcredir=/path/to/pcredir</command>) to manually specify a particular PCRE installation directory that PostGIS will build against.
ja: <ulink url="http://www.pcre.org/">PCRE</ulink>は、BSDライセンスのPerl互換正規表現ライブラリです。住所標準化エクステンションに必須です。PostGISのビルド対象としている特定のPCREを手動で指定する場合に、このパラメータ (<command>--with-pcredir=/path/to/pcredir</command>)を使います。

note: Tag: para
en: Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-gui graphical interface to shp2pgsql.
ja: データインポートGUI (GTK+2.0が必要)をコンパイルします。このパラメータによって、shp2pgsql-guiという、shp2pgsqlのグラフィカルユーザインタフェースが作成されます。

note: Tag: para
en: Compile with raster support. This will build rtpostgis-&last_release_version; library and rtpostgis.sql file. This may not be required in final release as plan is to build in raster support by default.
ja: ラスタ機能付きでコンパイルします。これによりrtpostgis-&last_release_version;ライブラリとrtpostgis.sqlファイルが生成されます。最終リリースでは、デフォルトでラスタ機能付きにする予定ですので、このパラメータ自体は不要になる可能性があります。

note: Tag: para
en: Disable topology support. There is no corresponding library as all logic needed for topology is in postgis-&last_release_version; library.
ja: トポロジ対応を無くしてコンパイルします。トポロジに必要なロジックは全てpostgis-&last_release_version;ライブラリ内に作られるので、関連ライブラリはありません。

note: Tag: para
en: By default PostGIS will try to detect gettext support and compile with it, however if you run into incompatibility issues that cause breakage of loader, you can disable it entirely with this command. Refer to ticket <ulink url="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</ulink> for an example issue solved by configuring with this. NOTE: that you aren't missing much by turning this off. This is used for international help/label support for the GUI loader which is not yet documented and still experimental.
ja: デフォルトでは、gettextの検出とこれを用いたコンパイルを試みますが、ローダ破損を引き起こす非互換性問題のもとで実行する場合には、このコマンドで無効にできます。これを使ったコンフィギュレーションによって解決する問題の例は<ulink url="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</ulink>にあります。ご注意: これを切ることで多くの機能がなくなるわけではありません。まだ文書化されていなくて試験段階であるGUIローダにおける内部のヘルプ/ラベル機能に使われています。

note: Tag: para
en: By default PostGIS will not install with sfcgal support without this switch. <varname>PATH</varname> is an optional argument that allows to specify an alternate PATH to sfcgal-config.
ja: デフォルトでは、このスイッチなしではSFCGAL対応でインストールされません。<varname>PATH</varname>は、sfcgal-configへのパスを指定することができる追加的な引数です。

note: Tag: para
en: If you obtained PostGIS from the SVN <ulink url="http://svn.osgeo.org/postgis/trunk/"> repository </ulink> , the first step is really to run the script
ja: PostGISをSVN<ulink url="http://svn.osgeo.org/postgis/trunk/">レポジトリ</ulink>から得る場合には、はじめに次のスクリプトを実行します。

note: Tag: para
en: This script will generate the <command>configure</command> script that in turn is used to customize the installation of PostGIS.
ja: このスクリプトによって<command>configure</command>スクリプトが生成されます。これはPostGISのインストールに関するカスタマイズに使われます。

note: Tag: para
en: If you instead obtained PostGIS as a tarball, running <command>./autogen.sh</command> is not necessary as <command>configure</command> has already been generated.
ja: PostGISをアーカイブファイルで入手する場合には、<command>configure</command>が既に生成されているので<command>./autogen.sh</command>は不要です。

note: Tag: title
en: Building
ja: ビルド

note: Tag: para
en: Once the Makefile has been generated, building PostGIS is as simple as running
ja: Makefileが生成されたら、PostGISのビルドは、次のコマンドを実行するだけです。

note: Tag: para
en: The last line of the output should be "<code>PostGIS was built successfully. Ready to install.</code>"
ja: 出力の最後の行に"<code>PostGIS was built successfully. Ready to install.</code>"と出れば終わりです。

note: Tag: para
en: As of PostGIS v1.4.0, all the functions have comments generated from the documentation. If you wish to install these comments into your spatial databases later, run the command which requires docbook. The postgis_comments.sql and other package comments files raster_comments.sql, topology_comments.sql are also packaged in the tar.gz distribution in the doc folder so no need to make comments if installing from the tar ball. Comments are also included as part of the CREATE EXTENSION install.
ja: PostGIS 1.4.0版からは、全ての関数に文書から生成されるコメントが付きます。これらのコメントを後からインストールするには、次のコマンドを実行しますが、docbookが必要です。アーカイブファイルからインストールする場合は、postgis_comments.sql, raster_comments.sql, topology_comments.sqlは、docフォルダにあるので、コメントを作成する必要はありません。コメントはCREATE EXTENSIONによるインストールの一部として取り込まれます。

note: Tag: para
en: Introduced in PostGIS 2.0. This generates html cheat sheets suitable for quick reference or for student handouts. This requires xsltproc to build and will generate 4 files in doc folder <filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>
ja: PostGIS 2.0で導入されました。早見表に、または学習中の方のハンドアウトに適しているHTMLチートシートを生成します。xsltprocが必要で、<filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>の4ファイルが生成されます。

note: Tag: para
en: You can download some pre-built ones available in html and pdf from <ulink url="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</ulink>
ja: HTMLとPDFのビルド済みのものは<ulink url="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</ulink>にあります。

note: Tag: title
en: Building PostGIS Extensions and Deploying them
ja: PostGISエクステンションのビルドとデプロイ

note: Tag: para
en: The PostGIS extensions are built and installed automatically if you are using PostgreSQL 9.1+.
ja: PostgreSQL 9.1以上を使用している場合は、PostGISエクステンションが自動的にビルド、インストールされます。

note: Tag: para
en: If you are building from source repository, you need to build the function descriptions first. These get built if you have docbook installed. You can also manually build with the statement:
ja: ソースレポジトリからビルドしている場合は、関数の記述を最初にビルドする必要があります。これらは、docbookがインストールされている時にビルドされます。手動でインストールするには次のようにします。

note: Tag: para
en: Building the comments is not necessary if you are building from a release tar ball since these are packaged pre-built with the tar ball already.
ja: アーカイブファイルからのビルドの場合は、ビルド済みのものがあるので、コメントのビルドは必須ではありません。

note: Tag: para
en: If you are building against PostgreSQL 9.1, the extensions should automatically build as part of the make install process. You can if needed build from the extensions folders or copy files if you need them on a different server.
ja: PostgreSQL 9.1を対象にビルドしている場合は、extensionsは自動的にmake install処理の一部としてビルドするべきです。必要ならextensionsフォルダからビルドできますし、他のサーバで必要ならファイルの複製ができます。

note: Tag: para
en: The extension files will always be the same for the same version of PostGIS regardless of OS, so it is fine to copy over the extension files from one OS to another as long as you have the PostGIS binaries already installed on your servers.
ja: エクステンションファイルは、OSに関係なく、常に同じ版のPostGISと同じです。PostGISバイナリを既にインストールしている限りは、エクステンションファイルをあるOSから別のものに複写して大丈夫です。

note: Tag: para
en: If you want to install the extensions manually on a separate server different from your development, You need to copy the following files from the extensions folder into the <filename>PostgreSQL / share / extension</filename> folder of your PostgreSQL install as well as the needed binaries for regular PostGIS if you don't have them already on the server.
ja: 開発用と異なる別のサーバでエクステンションを手動でインストールしたい場合は、サーバにない時に必要となる通常のPostGISのバイナリだけでなく、次のファイルをextensionsフォルダからPostgreSQLインストール先の<filename>PostgreSQL / share / extension</filename>フォルダに複写します。

note: Tag: para
en: These are the control files that denote information such as the version of the extension to install if not specified. <filename>postgis.control, postgis_topology.control</filename>.
ja: 指定されていない場合のインストールするエクステンションの版等の情報を示す制御ファイ<filename>postgis.control, postgis_topology.control</filename>。

note: Tag: para
en: All the files in the /sql folder of each extension. Note that these need to be copied to the root of the PostgreSQL share/extension folder <filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>
ja: エクステンションごとの/sqlフォルダにあるファイル全て。<filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>はPostgreSQL share/extensionフォルダの最上位に複写する必要があることに注意して下さい。

note: Tag: para
en: Once you do that, you should see <varname>postgis</varname>, <varname>postgis_topology</varname> as available extensions in PgAdmin -> extensions.
ja: 以上を実行すると、PgAdmin -> extensionで<varname>postgis</varname>, <varname>postgis_topology</varname>が有効なエクステンションとして見えます。

note: Tag: para
en: If you are using psql, you can verify that the extensions are installed by running this query:
ja: psqlを使う場合は、次のクエリを実行してエクステンションがインストールされていることを確認できます。

note: Tag: para
en: If you have the extension installed in the database you are querying, you'll see mention in the <varname>installed_version</varname> column. If you get no records back, it means you don't have postgis extensions installed on the server at all. PgAdmin III 1.14+ will also provide this information in the <varname>extensions</varname> section of the database browser tree and will even allow upgrade or uninstall by right-clicking.
ja: クエリを行ったデータベースにエクステンションがインストールされている場合は、<varname>installed_version</varname>カラムに記載が見えます。レコードが返ってこない場合は、PostGIS EXTENSIONがインストールされていないことになります。PgAdmin III 1.14以上では、データベースブラウザツリーの<varname>extensions</varname>セクションで提供されていて、右クリックでアップグレードまたアンインストールできます。

note: Tag: para
en: If you have the extensions available, you can install postgis extension in your database of choice by either using pgAdmin extension interface or running these sql commands:
ja: 有効なエクステンションがある場合、pgAdminエクステンションインタフェースまたは次のSQLの実行によって、選択したデータベースにPostGISエクステンションをインストールできます。

note: Tag: programlisting
en: CREATE EXTENSION postgis;
    CREATE EXTENSION postgis_sfcgal;
    CREATE EXTENSION fuzzystrmatch; --needed for postgis_tiger_geocoder
    --optional used by postgis_tiger_geocoder, or can be used standalone
    CREATE EXTENSION address_standardizer;
    CREATE EXTENSION address_standardizer_data_us;
    CREATE EXTENSION postgis_tiger_geocoder;
    CREATE EXTENSION postgis_topology;
ja: CREATE EXTENSION postgis;
    CREATE EXTENSION postgis_sfcgal;
    CREATE EXTENSION fuzzystrmatch; -- postgis_tiger_geocoderに必要
    -- postgis_tiger_geocoderで使用されるか単独で使われます
    CREATE EXTENSION address_standardizer;
    CREATE EXTENSION address_standardizer_data_us;
    CREATE EXTENSION postgis_tiger_geocoder;
    CREATE EXTENSION postgis_topology;

note: Tag: para
en: In psql you can use to see what versions you have installed and also what schema they are installed.
ja: psqlでは、どの版が、どのスキーマにインストールされているかを見ることができます。

note: Tag: para
en: Extension tables <varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname> can not be explicitly backed up. They can only be backed up when the respective <varname>postgis</varname> or <varname>postgis_topology</varname> extension is backed up, which only seems to happen when you backup the whole database. As of PostGIS 2.0.1, only srid records not packaged with PostGIS are backed up when the database is backed up so don't go around changing srids we package and expect your changes to be there. Put in a ticket if you find an issue. The structures of extension tables are never backed up since they are created with <code>CREATE EXTENSION</code> and assumed to be the same for a given version of an extension. These behaviors are built into the current PostgreSQL extension model, so nothing we can do about it.
ja: エクステンションのテーブル<varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname>は、明示的にバックアップできません。それぞれの<varname>postgis</varname>または<varname>postgis_topology</varname>エクステンションがバックアップされる時のみバックアップできます。これは、データベース全体のバックアップの時のみ行われます。PostGIS 2.0.1の時点では、データベースがバックアップされる際に、PostGISでパッケージ化されていないsridレコードのみバックアップされます。パッケージに入っているsridの変更は巡回せず、変更はそこにあるものと期待されます。PostGIS 2.0.1の時点では、データベースがバックアップされるときにPostGISに入っていないsridのレコードだけがバックアップされます。PostGISに入っていて後に変更されたsridの変更については巡回しません。問題が見られたら、チケットを発行して下さい。エクステンションテーブルの構造は<code>CREATE EXTENSION</code>で生成されるので、バックアップを行いません。エクステンションの与えられた版と同じものであると仮定されます。この挙動は現在のPostgreSQL エクステンションモデルに組み込まれているため、これについては何もできません。

note: Tag: para
en: If you installed &last_release_version;, without using our wonderful extension system, you can change it to be extension based by first upgrading to the latest micro version running the upgrade scripts: <filename>postgis_upgrade_22_minor.sql</filename>,<filename>raster_upgrade_22_minor.sql</filename>,<filename>topology_upgrade_22_minor.sql</filename>.
ja: この素晴らしいエクステンション機能を使わずに&last_release_version;をインストールした場合でもエクステンションベースに変更することができます。まず<filename>postgis_upgrade_22_minor.sql</filename>,<filename>raster_upgrade_22_minor.sql</filename>,<filename>topology_upgrade_22_minor.sql</filename>のアップグレードスクリプトを実行して最新版にアップグレードします

note: Tag: para
en: If you installed postgis without raster support, you'll need to install raster support first (using the full <filename>rtpostgis.sql</filename>
ja: ラスタ機能無しでPostGISをインストールした場合には、最初にラスタ機能をインストールする必要があります (<filename>rtpostgis.sql</filename>を使います)。

note: Tag: para
en: Then you can run the below commands to package the functions in their respective extension.
ja: それから、次のコマンドを実行して、個々のエクステンションについて、関数をパッケージ化します。

note: Tag: title
en: Testing
ja: テスト

note: Tag: para
en: If you wish to test the PostGIS build, run
ja: PostGISのテストを行うには、次のコマンドを実行します。

note: Tag: para
en: The above command will run through various checks and regression tests using the generated library against an actual PostgreSQL database.
ja: このコマンドで、実際のPostgreSQLデータベースに対して生成したライブラリを使用した、様々なチェックとレグレッションテストを行います。

note: Tag: para
en: If you configured PostGIS using non-standard PostgreSQL, GEOS, or Proj4 locations, you may need to add their library locations to the LD_LIBRARY_PATH environment variable.
ja: PostgreSQL, GEOS または Proj4 を標準の位置にインストールしていない場合には、環境変数LD_LIBRARY_PATHに、ライブラリの位置を追加する必要があるかも知れません。

note: Tag: para
en: Currently, the <command>make check</command> relies on the <code>PATH</code> and <code>PGPORT</code> environment variables when performing the checks - it does <emphasis>not</emphasis> use the PostgreSQL version that may have been specified using the configuration parameter <command>--with-pgconfig</command>. So make sure to modify your PATH to match the detected PostgreSQL installation during configuration or be prepared to deal with the impending headaches.
ja: 現在のところ<command>make check</command>は、チェックを行う際に 環境変数<code>PATH</code>と<code>PGPORT</code>によっています。コンフィギュレーションパラメータ<command>--with-pgconfig</command>を使って特定したPostgreSQLでは<emphasis>ありません</emphasis>。PATHを編集して、コンフィギュレーションの際に検出したPostgreSQLと一致するようにして下さい。もしくは、間もなく襲ってくる頭痛の準備をしておいて下さい。

note: Tag: para
en: If successful, the output of the test should be similar to the following:
ja: 成功した場合は、テストの出力は次のようなかんじになります。

note: Tag: para
en: The <varname>postgis_tiger_geocoder</varname> and <varname>address_standardizer</varname> extensions, currenlty only support the standard PostgreSQL installcheck. To test these use the below. Note: the make install is not necessary if you already did make install at root of PostGIS code folder.
ja: <varname>postgis_tiger_geocoder</varname>と<varname>address_standardizer</varname>は、現在は、標準的なPostgreSQLインストールチェックにのみ対応しています。これらをテストするには、次のようにします。ご注意: PostGISコードフォルダのルートでmake installを既に行っている場合には、make installは重要ではありません。

note: Tag: para
en: For address_standardizer:
ja: address_standardizer用:

note: Tag: para
en: Output should look like:
ja: 出力は次のようなかんじになります。

note: Tag: para
en: For tiger geocoder, make sure you have postgis and fuzzystrmatch extensions available in your PostgreSQL instance. The address_standardizer tests will also kick in if you built postgis with address_standardizer support:
ja: Tiger Geocodeを使う場合には、使用するPostgreSQLインスタンス内にPostGISとfuzzystrmatchのエクステンションが必要です。PostGISをaddress_standardizer機能付きでビルドした場合は、address_standardizerのテストも行います。

note: Tag: para
en: output should look like:
ja: 出力は次のようなかんじになります。

note: Tag: title
en: Installation
ja: インストール

note: Tag: para
en: To install PostGIS, type
ja: PostGISをインストールするには、次のコマンドを実行します。

note: Tag: para
en: This will copy the PostGIS installation files into their appropriate subdirectory specified by the <command>--prefix</command> configuration parameter. In particular:
ja: これにより、PostGISのインストールファイルが、<command>--prefix</command>パラメータで指定した、適切なサブディレクトリに複写されます。次に特筆すべきサブディレクトリを示します。

note: Tag: para
en: The loader and dumper binaries are installed in <filename>[prefix]/bin</filename>.
ja: ローダとダンパのバイナリのインストール先は<filename>[prefix]/bin</filename>です。

note: Tag: para
en: The SQL files, such as <filename>postgis.sql</filename>, are installed in <filename>[prefix]/share/contrib</filename>.
ja: <filename>postgis.sql</filename>などのSQLファイルのインストール先は<filename>[prefix]/share/contrib</filename>です。

note: Tag: para
en: The PostGIS libraries are installed in <filename>[prefix]/lib</filename>.
ja: PostGISライブラリのインストール先は<filename>[prefix]/lib</filename>です。

note: Tag: para
en: If you previously ran the <command>make comments</command> command to generate the <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename> file, install the sql file by running
ja: 先に<command>make comments</command>を実行して<filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>を生成していた場合は、次のコマンドを実行すると、これらのSQLファイルがインストールされます。

note: Tag: para
en: <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, <filename>topology_comments.sql</filename> was separated from the typical build and installation targets since with it comes the extra dependency of <command>xsltproc</command>.
ja: <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, <filename>topology_comments.sql</filename>は、<command>xsltproc</command>の外部依存ができたので、通常のビルドとインストールから切り離されました。

note: Tag: title
en: Creating a spatial database using EXTENSIONS
ja: エクステンションを使った空間データベースの生成

note: Tag: para
en: If you are using PostgreSQL 9.1+ and have compiled and installed the extensions/ postgis modules, you can create a spatial database the new way.
ja: PostgreSQL 9.1以上を使っていて、extensions/postgisモジュールをコンパイルとインストールを行っている場合は、新しい方法で空間データベースを生成できます。

note: Tag: command
en: createdb [yourdatabase]
ja: createdb [データベース名]

note: Tag: para
en: The core postgis extension installs PostGIS geometry, geography, raster, spatial_ref_sys and all the functions and comments with a simple: <programlisting>CREATE EXTENSION postgis;</programlisting> command.
ja: PostGISエクステンションの中核によって、ジオメトリ、ジオグラフィ、ラスタ、spatial_ref_sysおよび全ての関数とコメントがインストールされます。次のコマンドを実行するだけです。<programlisting>CREATE EXTENSION postgis;</programlisting>

note: Tag: command
en: psql -d [yourdatabase] -c "CREATE EXTENSION postgis;"
ja: psql -d [データベース名] -c "CREATE EXTENSION postgis;"

note: Tag: para
en: Topology is packaged as a separate extension and installable with command:
ja: トポロジは別のエクステンションとして用意されています。次のコマンドでインストールします。

note: Tag: command
en: psql -d [yourdatabase] -c "CREATE EXTENSION postgis_topology;"
ja: psql -d [データベース名] -c "CREATE EXTENSION postgis_topology;"

note: Tag: para
en: If you plan to restore an old backup from prior versions in this new db, run:
ja: 以前の版の古いバックアップを新しいデータベースにリストアする予定の場合には、次を実行します。

note: Tag: command
en: psql -d [yourdatabase] -f legacy.sql
ja: psql -d [データベース名] -f legacy.sql

note: Tag: para
en: If you need legacy functions, you'll need to reinstall the legacy.sql script whenever you upgrade the minor version of PostGIS. E.g. if you upgraded from 2.4.3 to 2.5.0, then you need to reinstall the legacy.sql packaged with 2.5.0. This is because some of the functions make reference to the library and the library is named with the minor in it.
ja: レガシー関数が必要なら、PostGISのマイナーバージョンのアップグレードならいつでも、legacy.sqlスクリプトの再インストールが必要です。例えば、2.4.3から2.5.0にアップグレードした場合には、2.5.0のlegacy.sqlの再インストールが必要です。関数の中にライブラリへの参照を作るものがあり、ライブラリ名にマイナー版番号を含むためです。

note: Tag: para
en: You can later run <filename>uninstall_legacy.sql</filename> to get rid of the deprecated functions after you are done with restoring and cleanup.
ja: リストアとクリーンアップを行った後で非推奨関数を消すために<filename>uninstall_legacy.sql</filename>を実行できます。

note: Tag: title
en: Create a spatially-enabled database without using extensions
ja: 空間データベースをエクステンションを使わずに生成する

note: Tag: para
en: This is generally only needed if you built-PostGIS without raster support. Since raster functions are part of the postgis extension, extension support is not enabled if PostGIS is built without raster.
ja: この情報は、一般的には、PostGISをラスタ対応なしでビルドした場合のみ必要となります。ラスタ関数はPostGISエクステンションの一部であり、ラスタ対応無しでPostGISをビルドする場合には、エクステンション対応が無効になるためです。

note: Tag: para
en: The first step in creating a PostGIS database is to create a simple PostgreSQL database.
ja: PostGISデータベースを作る最初のステップは、単純なPostgreSQLデータベースの作成です。

note: Tag: para
en: Many of the PostGIS functions are written in the PL/pgSQL procedural language. As such, the next step to create a PostGIS database is to enable the PL/pgSQL language in your new database. This is accomplish by the command below command. For PostgreSQL 8.4+, this is generally already installed
ja: 多くのPostGIS関数は、PL/pgSQL手続き言語で書かれています。次のステップは、PL/pgSQL言語を新たに作成したデータベースで有効にすることです。次のコマンドを実行します。PostgreSQL 8.4以上では、通常は既にインストールされています。

note: Tag: command
en: createlang plpgsql [yourdatabase]
ja: createlang plpgsql [データベース名]

note: Tag: para
en: Now load the PostGIS object and function definitions into your database by loading the <filename>postgis.sql</filename> definitions file (located in <filename>[prefix]/share/contrib</filename> as specified during the configuration step).
ja: 次に、PostGISオブジェクトと関数定義をデータベースにロードします。定義ファイル<filename>postgis.sql</filename>(コンフィギュレーション段階で指定した<filename>[prefix]/share/contrib</filename>にあります)をロードします。

note: Tag: command
en: psql -d [yourdatabase] -f postgis.sql
ja: psql -d [データベース名] -f postgis.sql

note: Tag: para
en: For a complete set of EPSG coordinate system definition identifiers, you can also load the <filename>spatial_ref_sys.sql</filename> definitions file and populate the <varname>spatial_ref_sys</varname> table. This will permit you to perform ST_Transform() operations on geometries.
ja: 完全なEPSG座標系定義IDセットについては、<filename>spatial_ref_sys.sql</filename>定義ファイルをロードして<varname>spatial_ref_sys</varname>テーブルを生成して下さい。これによりジオメトリ関数ST_Transform()が実行できるようになります。

note: Tag: command
en: psql -d [yourdatabase] -f spatial_ref_sys.sql
ja: psql -d [データベース名] -f spatial_ref_sys.sql

note: Tag: para
en: If you wish to add comments to the PostGIS functions, the final step is to load the <filename>postgis_comments.sql</filename> into your spatial database. The comments can be viewed by simply typing <command>\dd [function_name]</command> from a <command>psql</command> terminal window.
ja: PostGISが持つ関数についての助けとなるコメントを求めるなら、<filename>postgis_comments.sql</filename>を、データベースにロードします。コメントは、<command>psql</command>ターミナルウィンドウで単に<command>\dd [function_name]</command>とすれば見ることができます。ロードは次のようにします。

note: Tag: command
en: psql -d [yourdatabase] -f postgis_comments.sql
ja: psql -d [データベース名] -f postgis_comments.sql

note: Tag: para
en: Install raster support
ja: ラスタ機能をインストールします。

note: Tag: command
en: psql -d [yourdatabase] -f rtpostgis.sql
ja: psql -d [データベース名] -f rtpostgis.sql

note: Tag: para
en: Install raster support comments. This will provide quick help info for each raster function using psql or PgAdmin or any other PostgreSQL tool that can show function comments
ja: ラスタ機能のコメントをインストールします。ラスタ関数ごとの簡易説明が提供されます。psqlまたはpgAdmin等の関数コメントを表示できるPostgreSQLツールで使えます。

note: Tag: command
en: psql -d [yourdatabase] -f raster_comments.sql
ja: psql -d [データベース名] -f raster_comments.sql

note: Tag: para
en: Install topology support
ja: トポロジ機能をインストールします。

note: Tag: command
en: psql -d [yourdatabase] -f topology/topology.sql
ja: psql -d [データベース名] -f topology/topology.sql

note: Tag: para
en: Install topology support comments. This will provide quick help info for each topology function / type using psql or PgAdmin or any other PostgreSQL tool that can show function comments
ja: トポロジ機能のコメントをインストールします。トポロジ関数/型ごとの簡易説明が提供されます。psqlまたはpgAdmin等の関数コメントを表示できるPostgreSQLツールで使えます。

note: Tag: command
en: psql -d [yourdatabase] -f topology/topology_comments.sql
ja: psql -d [データベース名] -f topology/topology_comments.sql

note: Tag: para
en: There is an alternative <filename>legacy_minimal.sql</filename> you can run instead which will install barebones needed to recover tables and work with apps like MapServer and GeoServer. If you have views that use things like distance / length etc, you'll need the full blown <filename>legacy.sql</filename>
ja: テーブルを回復し、MapServerやGeoServerのようなアプリケーションで動作させるのに必要な最低限をインストールするには<filename>legacy_minimal.sql</filename>という選択肢があります。distance/length等のようなものを使うビューがあるなら、完全な<filename>legacy.sql</filename>が必要になります。

note: Tag: title
en: Installing and Using the address standardizer
ja: PAGC住所標準化ツールのインストールと使用

note: Tag: para
en: The <code>address_standardizer</code> extension used to be a separate package that required separate download. From PostGIS 2.2 on, it is now bundled in. For more information about the address_standardize, what it does, and how to configure it for your needs, refer to <xref linkend="Address_Standardizer"/>.
ja: <code>address_standardizer</code>エクステンションは、別途ダウンロードする必要がある別パッケージとしていました。PostGIS 2.2からは同梱されています。address_standardizeの追加情報、できること、および、コンフィギュレーション方法については、<xref linkend="Address_Standardizer"/>をご覧下さい。

note: Tag: para
en: This standardizer can be used in conjunction with the PostGIS packaged tiger geocoder extension as a replacement for the <xref linkend="Normalize_Address"/> discussed. To use as replacement refer to <xref linkend="tiger_pagc_address_standardizing"/>. You can also use it as a building block for your own geocoder or use it to standardize your addresses for easier compare of addresses.
ja: 標準化エクステンションは、<xref linkend="Normalize_Address"/>の後継で、PostGISに入っているTigerジオコーダエクステンションに使うことができます。この場合の使い方については<xref linkend="tiger_pagc_address_standardizing"/>を参照して下さい。また、ユーザ自身がつくるジオコーダの要素として使用したり、住所の比較を簡単にするために住所を標準化するために使うことができます。

note: Tag: para
en: The address standardizer relies on PCRE which is usually already installed on many Nix systems, but you can download the latest at: <ulink url="http://www.pcre.org">http://www.pcre.org</ulink>. If during <xref linkend="installation_configuration"/>, PCRE is found, then the address standardizer extension will automatically be built. If you have a custom pcre install you want to use instead, pass to configure <code>--with-pcredir=/path/to/pcre</code> where <filename>/path/to/pcre</filename> is the root folder for your pcre include and lib directories.
ja: 住所標準化エクステンションはPCREに依存しています。PCREは多くのUNIX系システムにインストールされていますが、<ulink url="http://www.pcre.org">http://www.pcre.org</ulink>から最新版をダウンロードできます。<xref linkend="installation_configuration"/>の際にPCREを発見すると、住所標準化エクステンションが自動的にビルドされます。使用したいPCREのインストールが独自なものである場合は、configureに<code>--with-pcredir=/path/to/pcre</code>を渡します。<filename>/path/to/pcre</filename>は、PCREのincludeとlibのあるルートフォルダです。

note: Tag: para
en: For Windows users, the PostGIS 2.1+ bundle is packaged with the address_standardizer already so no need to compile and can move straight to <code>CREATE EXTENSION</code> step.
ja: Windowsでは、PostGIS 2.1以上に住所標準化エクステンションが同梱されているので、コンパイルを行わずに、すぐに<code>CREATE EXTENSION</code>に行くことができます。

note: Tag: para
en: Once you have installed, you can connect to your database and run the SQL:
ja: インストールしたら、対象データベースに接続して次のSQLが実行できます。

note: Tag: para
en: The following test requires no rules, gaz, or lex tables
ja: 次のテストでは、rules, gaz, lexテーブルは必要ありません。

note: Tag: para
en: Output should be
ja: 出力は次のようになります。

note: Tag: title
en: Installing Regex::Assemble
ja: Regex::Assembleのインストール

note: Tag: para
en: Perl Regex:Assemble is no longer needed for compiling address_standardizer extension since the files it generates are part of the source tree. However if you need to edit the <filename>usps-st-city-orig.txt</filename> or <filename>usps-st-city-orig.txt usps-st-city-adds.tx</filename>, you need to rebuild <filename>parseaddress-stcities.h</filename> which does require Regex:Assemble.
ja: PerlのRegex::Assembleは、ソースツリーの一部がこれで作られていますが、住所標準化エクステンションではもはや不要です。ただし、<filename>usps-st-city-orig.txt</filename>または<filename>usps-st-city-orig.txt usps-st-city-adds.tx</filename>を編集する必要がある場合は、<filename>parseaddress-stcities.h</filename>のリビルドでRegex:Assembleが必要です。

note: Tag: para
en: or if you are on Ubuntu / Debian you might need to do
ja: Ubuntu / Degianの場合には、次のようにしなければならないかも知れません。

note: Tag: title
en: Installing, Upgrading Tiger Geocoder and loading data
ja: Tigerジオコーダのインストールとアップグレードとデータロード

note: Tag: para
en: Extras like Tiger geocoder may not be packaged in your PostGIS distribution. If you are missing the tiger geocoder extension or want a newer version than what your install comes with, then use the <filename>share/extension/postgis_tiger_geocoder.*</filename> files from the packages in <ulink url="http://postgis.net/windows_downloads/">Windows Unreleased Versions</ulink> section for your version of PostgreSQL. Although these packages are for windows, the postgis_tiger_geocoder extension files will work on any OS since the extension is an SQL/plpgsql only extension.
ja: Tigerジオコーダのような拡張機能はPostGISディストリビューションに同梱されていません。Tigerジオコーダエクステンションが無かったり、インストールしているものより新しい版のものが欲しい場合には、<ulink url="http://postgis.net/windows_downloads/">Windows Unreleased Versions</ulink>節でPostgreSQLの版に合ったパッケージにある<filename>share/extension/postgis_tiger_geocoder.*</filename>ファイルを使います。これらのパッケージはWindows用ですが、postgis_tige_geocoderエクステンションファイルは、SQLとPL/pgSQLだけですので、他のOSでも動作します。

note: Tag: title
en: Tiger Geocoder Enabling your PostGIS database: Using Extension
ja: TigerジオコーダをPostGISデータベースで有効にする: エクステンションを使用

note: Tag: para
en: If you are using PostgreSQL 9.1+ and PostGIS 2.1+, you can take advantage of the new extension model for installing tiger geocoder. To do so:
ja: PostgreSQL 9.1以上とPostGIS 2.1.0を使用している場合は、Tigerジオコーダのインストールで、新しいエクステンションモデルの利点を得ることができます。次のようにします。

note: Tag: para
en: First get binaries for PostGIS 2.1+ or compile and install as usual. This should install the necessary extension files as well for tiger geocoder.
ja: まず、通常の方法で、PostGIS 2.1.0のバイナリを取得するか、コンパイルしてインストールします。これにより重要なエクステンションファイルとTigerジオコーダのファイルがインストールされます。

note: Tag: para
en: Connect to your database via psql or pgAdmin or some other tool and run the following SQL commands. Note that if you are installing in a database that already has postgis, you don't need to do the first step. If you have <varname>fuzzystrmatch</varname> extension already installed, you don't need to do the second step either.
ja: psql、pgAdminまたは他のツールでデータベースに接続して、次のSQLコマンドを実行します。既にPostGISを持っているデータベースにインストールする場合は、一つ目の手順は不要です。<varname>fuzzystrmatch</varname>エクステンションが既にインストールされている場合は、二つ目の手順は不要です。

note: Tag: programlisting
en: CREATE EXTENSION postgis;
    CREATE EXTENSION fuzzystrmatch;
    CREATE EXTENSION postgis_tiger_geocoder;
    --this one is optional if you want to use the rules based standardizer (pagc_normalize_address)
    CREATE EXTENSION address_standardizer;
ja: CREATE EXTENSION postgis;
    CREATE EXTENSION fuzzystrmatch;
    CREATE EXTENSION postgis_tiger_geocoder;
    -- 規則を基にした住所標準化 (pagc_normalize_address)を使いたい場合の任意実行
    CREATE EXTENSION address_standardizer;

note: Tag: para
en: If you already have postgis_tiger_geocoder extension installed, and just want to update to the latest run:
ja: 既にpostgis_tiger_geocoderエクステンションをインストールしていて、最新版に更新するだけの場合には、次を実行します。

note: Tag: para
en: If you made custom entries or changes to <varname>tiger.loader_platform</varname> and <varname>tiger.loader_variables</varname> you may need to update these.
ja: 独自のエントリを生成した場合や、<varname>tiger.loader_platform</varname>と<varname>tiger.loader_variables</varname>に変更を加えた場合には、これらをアップデートしなければならないことがあります。

note: Tag: para
en: To confirm your install is working correctly, run this sql in your database:
ja: 正しくインストールされたかを確認するために、インストール対象データベース内で次のSQLを実行します。

note: Tag: para
en: Which should output
ja: 出力は次のようになります。

note: Tag: para
en: Create a new record in <varname>tiger.loader_platform</varname> table with the paths of your executables and server.
ja: <varname>tiger.loader_platform</varname>テーブルの、実行ファイルやサーバのパスを持つ新しいレコードを生成します。

note: Tag: para
en: So for example to create a profile called debbie that follows <code>sh</code> convention. You would do:
ja: <code>sh</code>コンベンションのあとにdebbieというプロファイルを生成する例として、次のコマンドを実行します。

note: Tag: para
en: And then edit the paths in the <emphasis>declare_sect</emphasis> column to those that fit Debbie's pg, unzip,shp2pgsql, psql, etc path locations.
ja: それから、<emphasis>declare_sect</emphasis>カラム内のパスを編集して、Debbieのpg, unzip, shp2pgsql, psql他のパス位置に適応するようにします。

note: Tag: para
en: If you don't edit this <varname>loader_platform</varname> table, it will just contain common case locations of items and you'll have to edit the generated script after the script is generated.
ja: <varname>loader_platform</varname>テーブルを編集しない場合は、一般的なアイテムの位置を持っているので、スクリプトが生成された後で、スクリプトを編集しなければなりません。

note: Tag: para
en: As of PostGIS 2.4.1 the Zip code-5 digit tabulation area <varname>zcta5</varname> load step was revised to load current zcta5 data and is part of the <xref linkend="Loader_Generate_Nation_Script"/> when enabled. It is turned off by default because it takes quite a bit of time to load (20 to 60 minutes), takes up quite a bit of disk space, and is not used that often.
ja: PostGIS 2.4.1からは、<varname>ZTCA5</varname> (Zip Code 5 digit Tabulation Area)のロード手順が変更され、有効になった時に<xref linkend="Loader_Generate_Nation_Script"/>の一部として現在のZCTA5データをロードするようになりました。デフォルトでは切られています。ロードにかなりの時間 (20から60分)が取られ、かなりのディスクスペースを占有するのに、そんなに頻繁には使わないためです。

note: Tag: para
en: To enable it, do the following:
ja: 有効にするには、次のようにします。

note: Tag: para
en: If present the <xref linkend="Geocode"/> function can use it if a boundary filter is added to limit to just zips in that boundary. The <xref linkend="Reverse_Geocode"/> function uses it if the returned address is missing a zip, which often happens with highway reverse geocoding.
ja: 境界のフィルタが追加され、ちょうど境界内のZIPに制限された場合に、<xref linkend="Geocode"/>関数は、ZCTA5が存在するなら使います。<xref linkend="Reverse_Geocode"/>関数は、返された住所にZIPコードが無い場合に (しばしば高速道路での逆ジオコーディングで発生します)、これを使います。

note: Tag: para
en: Create a folder called <filename>gisdata</filename> on root of server or your local pc if you have a fast network connection to the server. This folder is where the tiger files will be downloaded to and processed. If you are not happy with having the folder on the root of the server, or simply want to change to a different folder for staging, then edit the field <varname>staging_fold</varname> in the <varname>tiger.loader_variables</varname> table.
ja: サーバまたはローカル (サーバへのネットワーク接続が早い場合)のルートに<filename>gisdata</filename>というフォルダを作成します。このフォルダはTigerファイルがダウンロードされ、処理される場所です。サーバのルートにフォルダを作ると不幸になる場合や、単に他のフォルダに移したい場合には、<varname>tiger.loader_variables</varname>テーブルの<varname>staging_fold</varname>フィールドを編集します。

note: Tag: para
en: Create a folder called temp in the <filename>gisdata</filename> folder or whereever you designated the <varname>staging_fold</varname> to be. This will be the folder where the loader extracts the downloaded tiger data.
ja: <filename>gisdata</filename>フォルダ内にtempというフォルダを作成します。もしくは、<varname>staging_fold</varname>で示されたフォルダを作成します。ローダがダウンロードしたTigerデータを展開する場所です。

note: Tag: para
en: Then run the <xref linkend="Loader_Generate_Nation_Script"/> SQL function make sure to use the name of your custom profile and copy the script to a .sh or .bat file. So for example to build the nation load:
ja: そして、SQL関数<xref linkend="Loader_Generate_Nation_Script"/>を実行して、独自のプロファイルの名前を使うか確認し、.shまたは.batファイルにスクリプトを複写します。たとえば、新しいプロファイルで国のロードを行う場合には、次のようにします。

note: Tag: para
en: Run the generated nation load commandline scripts.
ja: 生成された国データをロードするコマンドラインスクリプトを実行します。

note: Tag: para
en: After you are done running the nation script, you should have three tables in your <code>tiger_data</code> schema and they should be filled with data. Confirm you do by doing the following queries from psql or pgAdmin
ja: 国スクリプトを実行した後、<code>tiger_data</code>スキーマに三つのテーブルが作られ、データが格納されています。次のクエリをpsqlかpgAdminから実行して、確認します。

note: Tag: para
en: By default the tables corresponding to <varname>bg</varname>, <varname>tract</varname>, <varname>tabblock</varname> are not loaded. These tables are not used by the geocoder but are used by folks for population statistics. If you wish to load them as part of your state loads, run the following statement to enable them.
ja: デフォルトでは<varname>bg</varname>, <varname>tract</varname>, <varname>tabblock</varname>に対応するテーブルはロードされません。ジオコーダはこれらのテーブルを使いませんが、一般に、人口統計に使います。州データのロードの一部としてロードするには、次の手続きを実行して有効にします。

note: Tag: para
en: Alternatively you can load just these tables after loading state data using the <xref linkend="Loader_Generate_Census_Script"/>
ja: もしくは、<xref linkend="Loader_Generate_Census_Script"/>を使って州のデータをロードした後に、これらのテーブルだけをロードできます。

note: Tag: para
en: For each state you want to load data for, generate a state script <xref linkend="Loader_Generate_Script"/>.
ja: データをロードしたい州ごとに、<xref linkend="Loader_Generate_Script"/>で州スクリプトを作ります。

note: Tag: para
en: DO NOT Generate the state script until you have already loaded the nation data, because the state script utilizes county list loaded by nation script.
ja: 国データのロードを完了する前に*州スクリプトを作ってはなりません*。州スクリプトは国スクリプトでロードされる国リストを利用するためです。

note: Tag: para
en: Run the generated commandline scripts.
ja: 生成されたコマンドラインスクリプトを実行します。

note: Tag: para
en: After you are done loading all data or at a stopping point, it's a good idea to analyze all the tiger tables to update the stats (include inherited stats)
ja: 全てのデータのロードが完了するか中断ポイントに達した後に、全てのtigerテーブルに対してanalyzeを実行して、(継承されたものも含めて)状態を更新するのは良いことです。

note: Tag: title
en: Converting a Tiger Geocoder Regular Install to Extension Model
ja: Tigerジオコーダ通常インストールのエクステンションモデルへの変換

note: Tag: para
en: If you installed the tiger geocoder without using the extension model, you can convert to the extension model as follows:
ja: エクステンションモデルを使わずにTigerジオコーダをインストールしている場合に、次のようにして、エクステンションモデルに変換できます。

note: Tag: para
en: Follow instructions in <xref linkend="upgrade_tiger_geocoder"/> for the non-extension model upgrade.
ja: <xref linkend="upgrade_tiger_geocoder" />の指示に従って非エクステンションモデルのアップグレードを行います。

note: Tag: para
en: Connect to your database with psql or pgAdmin and run the following command:
ja: psqlまたはpgAdminでデータベースに接続して、次のコマンドを実行します。

note: Tag: title
en: Tiger Geocoder Enabling your PostGIS database: Not Using Extensions
ja: TigerジオコーダをPostGISデータベースで有効にする: エクステンション不使用

note: Tag: para
en: First install PostGIS using the prior instructions.
ja: まず、上述の手順でPostGISをインストールします。

note: Tag: para
en: If you don't have an extras folder, download <ulink url="&postgis_download_url;">&postgis_download_url;</ulink>
ja: extrasフォルダが無い場合、<ulink url="&postgis_download_url;">&postgis_download_url;</ulink>をダウンロードします。

note: Tag: para
en: Edit the <filename>tiger_loader_2015.sql</filename> (or latest loader file you find, unless you want to load different year) to the paths of your executables server etc or alternatively you can update the <varname>loader_platform</varname> table once installed. If you don't edit this file or the <varname>loader_platform</varname> table, it will just contain common case locations of items and you'll have to edit the generated script after the fact when you run the <xref linkend="Loader_Generate_Nation_Script"/> and <xref linkend="Loader_Generate_Script"/> SQL functions.
ja: <filename>tiger_loader_2015.sql</filename> (違う年のものをロードしたくないならば最新のローダファイル)をあなたの実行サーバ等のパスに編集します。もしくは<varname>loader_platform</varname>がインストールされた後に一度これを更新します。このファイルも<varname>loader_platform</varname>も編集しない場合には、一般的なアイテムの位置を持っているだけなので、<xref linkend="Loader_Generate_Nation_Script"/>と<xref linkend="Loader_Generate_Script"/>を実行した後に、生成されたスクリプトを編集しなければなりません。

note: Tag: para
en: If you are installing Tiger geocoder for the first time edit either the <filename>create_geocode.bat</filename> script If you are on windows or the <filename>create_geocode.sh</filename> if you are on Linux/Unix/Mac OSX with your PostgreSQL specific settings and run the corresponding script from the commandline.
ja: 初めてTigerジオコーダをインストールする場合は、Windowsでは<filename>create_geocode.bat</filename>を、またLinux/Unix/Mac OSXでは<filename>create_geocode.sh</filename>を、使用するPostgreSQLにとって独自の設定に変更したうえで、コマンドラインから対応するスクリプトを実行します。

note: Tag: para
en: Verify that you now have a <varname>tiger</varname> schema in your database and that it is part of your database search_path. If it is not, add it with a command something along the line of:
ja: データベースに<varname>tiger</varname>スキーマがあることを確認します。もし無い場合は、次の行を参考に、コマンドを実行します。

note: Tag: para
en: The normalizing address functionality works more or less without any data except for tricky addresses. Run this test and verify things look like this:
ja: 住所正規化機能は、トリッキーな住所を除いて、大体データなしで動作します。テストを実行して次のように見えることを確認して下さい。

note: Tag: title
en: Using Address Standardizer Extension with Tiger geocoder
ja: TigerジオコーダをPostGISデータベースで有効にする: エクステンションを使用

note: Tag: para
en: One of the many complaints of folks is the address normalizer function <xref linkend="Normalize_Address"/> function that normalizes an address for prepping before geocoding. The normalizer is far from perfect and trying to patch its imperfectness takes a vast amount of resources. As such we have integrated with another project that has a much better address standardizer engine. To use this new address_standardizer, you compile the extension as described in <xref linkend="installing_pagc_address_standardizer"/> and install as an extension in your database.
ja: 皆さんが問題と思われるの多くのことのひとつに、ジオコーディング前の準備に住所を正規化する関数<xref linkend="Normalize_Address"/>があります。住所正規化は万全と言うにはほど遠く、パッチをあてようとすると膨大な資源を費やします。よって、より良い住所標準化エンジンを持つ他のプロジェクトに統合しました。この新しい住所標準化を使うには、<xref linkend="installing_pagc_address_standardizer"/>で記述するようにエクステンションをコンパイルし、使用するデータベースにインストールします。

note: Tag: para
en: Once you install this extension in the same database as you have installed <code>postgis_tiger_geocoder</code>, then the <xref linkend="Pagc_Normalize_Address"/> can be used instead of <xref linkend="Normalize_Address"/>. This extension is tiger agnostic, so can be used with other data sources such as international addresses. The tiger geocoder extension does come packaged with its own custom versions of <xref linkend="rulestab"/> ( <code>tiger.pagc_rules</code>) , <xref linkend="gaztab"/> (<code>tiger.pagc_gaz</code>), and <xref linkend="lextab"/> (<code>tiger.pagc_lex</code>). These you can add and update to improve your standardizing experience for your own needs.
ja: このエクステンションを<code>postgis_tiger_geocoder</code>をインストールしているデータベースにインストールすると、<xref linkend="Pagc_Normalize_Address"/>を、<xref linkend="Normalize_Address"/>の代わりに使うことができます。このエクステンションはTigerジオコーダからは見えないので、国際的な住所といった他のデータソースでも使えます。Tigerジオコーダエクステンションは、その版の<xref linkend="rulestab"/> (<code>tiger.pagc_rules</code>), <xref linkend="gaztab"/> (<code>tiger.pagc_gaz</code>), <xref linkend="lextab"/> (<code>tiger.pagc_lex</code>)を同梱しています。これらは、必要に応じて標準化の改善のために追加や更新ができます。

note: Tag: title
en: Loading Tiger Data
ja: Tigerデータのロード

note: Tag: para
en: The instructions for loading data are available in a more detailed form in the <filename>extras/tiger_geocoder/tiger_2011/README</filename>. This just includes the general steps.
ja: データロードの説明の詳細は<filename>extras/tiger_geocoder/tiger_2011/README</filename>にあります。これは一般的な手順を示しています。

note: Tag: para
en: The load process downloads data from the census website for the respective nation files, states requested, extracts the files, and then loads each state into its own separate set of state tables. Each state table inherits from the tables defined in <varname>tiger</varname> schema so that its sufficient to just query those tables to access all the data and drop a set of state tables at any time using the <xref linkend="Drop_State_Tables_Generate_Script"/> if you need to reload a state or just don't need a state anymore.
ja: ロードプロセスによって、米センサスウェブサイトから個々の国ファイル、リクエストされた州のデータをダウンロードし、ファイルを展開し、個別の州をそれぞれの州テーブルの集合にロードします。各州のテーブルは、<varname>tiger</varname>スキーマで定義されたテーブルを継承しているので、これらのテーブルに対して全てのデータにアクセスするためのクエリを出すことができますし、州の再読み込みが必要となったり、州が必要ない場合には、<xref linkend="Drop_State_Tables_Generate_Script"/>で、いつでも州テーブルの集合を削除するクエリを出すことができます。

note: Tag: para
en: In order to be able to load data you'll need the following tools:
ja: データのロードを可能にするためには次のツールが必要です。

note: Tag: para
en: A tool to unzip the zip files from census website.
ja: センサスウェブサイトから取得するZIPファイルを展開するツール。

note: Tag: para
en: For Unix like systems: <varname>unzip</varname> executable which is usually already installed on most Unix like platforms.
ja: Unix系システムでは、<varname>unzip</varname>実行ファイルです。通常は、ほとんどのUnix系プラットフォームで既にインストールされています。

note: Tag: para
en: For Windows, 7-zip which is a free compress/uncompress tool you can download from <ulink url="http://www.7-zip.org/">http://www.7-zip.org/</ulink>
ja: Windowsでは7-zipです。<ulink url="http://www.7-zip.org/">http://www.7-zip.org/</ulink>からダウンロードできる無償の圧縮解答ツールです。

note: Tag: para
en: <filename>shp2pgsql</filename> commandline which is installed by default when you install PostGIS.
ja: <filename>shp2pgsql</filename>コマンド。PostGISインストール時にデフォルトでインストールされます。

note: Tag: para
en: <filename>wget</filename> which is a web grabber tool usually installed on most Unix/Linux systems.
ja: <filename>wget</filename>コマンド。通常はほとんどのUnix/Linuxシステムにインストールされている、ウェブ取得ツールです。

note: Tag: para
en: If you are on windows, you can get pre-compiled binaries from <ulink url="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</ulink>
ja: Windows用については、コンパイル済みのバイナリを<ulink url="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</ulink>から取得できます。

note: Tag: para
en: If you are upgrading from tiger_2010, you'll need to first generate and run <xref linkend="Drop_Nation_Tables_Generate_Script"/>. Before you load any state data, you need to load the nation wide data which you do with <xref linkend="Loader_Generate_Nation_Script"/>. Which will generate a loader script for you. <xref linkend="Loader_Generate_Nation_Script"/> is a one-time step that should be done for upgrading (from 2010) and for new installs.
ja: tiger_2010からアップグレードする場合には、最初に<xref linkend="Drop_Nation_Tables_Generate_Script"/>を生成、実行する必要があります。州データをロードする前に、<xref linkend="Loader_Generate_Nation_Script"/>で国データをロードする必要があります。これによって、環境に合ったローダスクリプトが生成されます。<xref linkend="Loader_Generate_Nation_Script"/>は、一度の操作で、(2010からの)アップグレードと、新しいインストールが行われます。

note: Tag: para
en: To load state data refer to <xref linkend="Loader_Generate_Script"/> to generate a data load script for your platform for the states you desire. Note that you can install these piecemeal. You don't have to load all the states you want all at once. You can load them as you need them.
ja: 州データをロードするには、<xref linkend="Loader_Generate_Script"/>を参照して、手持ちのプラットフォームで動作する、求める州データをロードするデータロードスクリプトを生成します。州データはひとつずつダウンロードできることに注意して下さい。一度に必要な州の全てについてデータをロードする必要はありません。必要なだけダウンロードできます。

note: Tag: para
en: After the states you desire have been loaded, make sure to run the: <programlisting>SELECT install_missing_indexes();</programlisting> as described in <xref linkend="Install_Missing_Indexes"/>.
ja: 求める州データをロードした後は、<xref linkend="Install_Missing_Indexes"/>に示すように、<programlisting>SELECT install_missing_indexes();</programlisting>を実行するようにして下さい。

note: Tag: para
en: To test that things are working as they should, try to run a geocode on an address in your state using <xref linkend="Geocode"/>
ja: 行うべきことができたかをテストするために、<xref linkend="Geocode"/>を使用する州の中の住所についてジオコーダを実行してみます。

note: Tag: title
en: Upgrading your Tiger Geocoder Install
ja: Tigerジオコーダのアップグレード

note: Tag: para
en: If you have Tiger Geocoder packaged with 2.0+ already installed, you can upgrade the functions at any time even from an interim tar ball if there are fixes you badly need. This will only work for Tiger geocoder not installed with extensions.
ja: 2.0以上に含まれるTigerジオコーダがインストールされている場合には、どうしても必要な訂正があるときは、いつでも臨時のアーカイブファイルからでも機能のアップグレードができます。 これは、エクステンションでインストールされていないTigerジオコーダで動作します。

note: Tag: para
en: Locate the <filename>upgrade_geocoder.bat</filename> script If you are on windows or the <filename>upgrade_geocoder.sh</filename> if you are on Linux/Unix/Mac OSX. Edit the file to have your postgis database credentials.
ja: Windowsの場合は<filename>upgrade_geocoder.bat</filename>スクリプト、Linux/Unix/MacOS Xの場合は<filename>upgrade_geocoder.sh</filename>スクリプトの位置を特定します。 PostGISデータベースの資格情報を持つように編集します。

note: Tag: para
en: If you are upgrading from 2010 or 2011, make sure to unremark out the loader script line so you get the latest script for loading 2012 data.
ja: 2010または2011からアップグレードする場合には、確実にローダスクリプトのコメントアウトを消すと、2012データのロードのための最新のスクリプトを得ます。

note: Tag: para
en: Then run th corresponding script from the commandline.
ja: 対応するスクリプトをコマンドラインから実行します。

note: Tag: para
en: Next drop all nation tables and load up the new ones. Generate a drop script with this SQL statement as detailed in <xref linkend="Drop_Nation_Tables_Generate_Script"/>
ja: 次に、全ての国テーブルを削除し、新しい国テーブルをロードします。<xref linkend="Drop_Nation_Tables_Generate_Script"/>に詳細がある通り、このSQLステートメントを使った削除スクリプトを生成します。

note: Tag: para
en: Run the generated drop SQL statements.
ja: 生成した削除SQLステートメントを実行します。

note: Tag: para
en: Generate a nation load script with this SELECT statement as detailed in <xref linkend="Loader_Generate_Nation_Script"/>
ja: <xref linkend="Loader_Generate_Nation_Script"/>に詳細がある通り、このSELECTステートメントを使った削除スクリプトを生成します。

note: Tag: emphasis
en: For windows
ja: Windows向け

note: Tag: emphasis
en: For unix/linux
ja: Unix/Linux向け

note: Tag: para
en: Refer to <xref linkend="tiger_geocoder_loading_data"/> for instructions on how to run the generate script. This only needs to be done once.
ja: 生成したスクリプトの実行方法に関する説明は、<xref linkend="tiger_geocoder_loading_data"/>を参照して下さい。これは一度だけ実行する必要があります。

note: Tag: para
en: You can have a mix of 2010/2011 state tables and can upgrade each state separately. Before you upgrade a state to 2011, you first need to drop the 2010 tables for that state using <xref linkend="Drop_State_Tables_Generate_Script"/>.
ja: 2010/2011州テーブルを混在させることができ、それぞれの州について個別にアップグレードできます。2011にアップグレードする前に、まず、<xref linkend="Drop_State_Tables_Generate_Script"/>を使って、2010州テーブルを削除します。

note: Tag: title
en: Create a spatially-enabled database from a template
ja: 空間データベースをテンプレートから生成する

note: Tag: para
en: Some packaged distributions of PostGIS (in particular the Win32 installers for PostGIS &gt;= 1.1.5) load the PostGIS functions into a template database called <varname>template_postgis</varname>. If the <varname>template_postgis</varname> database exists in your PostgreSQL installation then it is possible for users and/or applications to create spatially-enabled databases using a single command. Note that in both cases, the database user must have been granted the privilege to create new databases.
ja: PostGISのディストリビューション (特にPostGIS &gt;= 1.1.5のWin32インストーラ)の中には、<varname>template_postgis</varname>というテンプレートにPostGIS関数をロードしていることがあります。PostgreSQLに<varname>template_postgis</varname>データベースが存在するなら、ユーザやアプリケーションは、空間データベースの生成をコマンドひとつで済ませられます。この2種類のやり方のどちらを使うににしても、データベースユーザは、新しいデータベースを作成する権限を与えられている必要があります。

note: Tag: para
en: From the shell:
ja: シェルからの実行は次の通りです。

note: Tag: para
en: From SQL:
ja: SQLからの実行は次の通りです。

note: Tag: title
en: Upgrading
ja: アップグレード

note: Tag: para
en: Upgrading existing spatial databases can be tricky as it requires replacement or introduction of new PostGIS object definitions.
ja: 既存の空間データベースのアップグレードは、新しいPostGISオブジェクト定義の置き換えや導入を必要とするとき、慎重を要することがあります。

note: Tag: para
en: Unfortunately not all definitions can be easily replaced in a live database, so sometimes your best bet is a dump/reload process.
ja: 不幸なことに、定義の全てが実行中のデータベース内で簡単には置き換えられるわけではないので、ダンプ/リロードが最善策となることがあります。

note: Tag: para
en: PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and a HARD UPGRADE procedure for major releases.
ja: PostGISには、マイナーバージョンアップやバグフィクスリリースの場合に使うソフトアップグレードと、メジャーアップグレードで使うハードアップグレードが用意されています。

note: Tag: para
en: Before attempting to upgrade PostGIS, it is always worth to backup your data. If you use the -Fc flag to pg_dump you will always be able to restore the dump with a HARD UPGRADE.
ja: PostGISをアップグレードしようとする前にデータのバックアップを取ることは、常に価値のあるものです。pg_dumpで -Fc フラグを使うと、ハードアップグレードによってダンプを常にリストアすることができます。

note: Tag: title
en: Soft upgrade
ja: ソフトアップグレード

note: Tag: para
en: If you installed your database using extensions, you'll need to upgrade using the extension model as well. If you installed using the old sql script way, then you should upgrade using the sql script way. Please refer to the appropriate.
ja: エクステンションを使ってインストールした場合は、エクステンションモデルでアップグレードしなければなりません。 古いSQLスクリプトを使ってインストールした場合は、SQLスクリプトでアップグレードすべきです。適切な方を参照して下さい。

note: Tag: title
en: Soft Upgrade Pre 9.1+ or without extensions
ja: 9.1より前またはエクステンションを使わないソフトアップグレード

note: Tag: para
en: This section applies only to those who installed PostGIS not using extensions. If you have extensions and try to upgrade with this approach you'll get messages like:
ja: PostGISをエクステンションを使わずにインストールした人向けです。エクステンションを使っていてこの方法を使うと、次のようなメッセージが現れます。

note: Tag: para
en: After compiling and installing (make install) you should find a <filename>postgis_upgrade.sql</filename> and <filename>rtpostgis_upgrade.sql</filename> in the installation folders. For example <filename>/usr/share/postgresql/9.3/contrib/postgis_upgrade.sql</filename>. Install the <filename>postgis_upgrade.sql</filename>. If you have raster functionality installed, you will also need to install the <filename>/usr/share/postgresql/9.3/contrib/postgis_upgrade.sql</filename>. If you are moving from PostGIS 1.* to PostGIS 2.* or from PostGIS 2.* prior to r7409, you need to do a HARD UPGRADE.
ja: コンパイルとインストールの後に<filename>postgis_upgrade.sql</filename>と<filename>rtpostgis_upgrade.sql</filename>を探して下さい。たとえば<filename>/usr/share/postgresql/9.3/contrib/postgis_upgrade.sql</filename>です。<filename>postgis_upgrade.sql</filename>をインストールして下さい。ラスタ機能をインストールしている場合には、<filename>/usr/share/postgresql/9.3/contrib/rtpostgis_upgrade.sql</filename>もインストールします。PostGIS 1.*から2.*に移動したり、2.*からr7409以前に落とす場合は、ハードアップグレードして下さい。

note: Tag: programlisting
en: psql -f postgis_upgrade.sql -d your_spatial_database
ja: psql -f postgis_upgrade.sql -d [データベース名]

note: Tag: para
en: The same procedure applies to raster and topology extensions, with upgrade files named <filename>rtpostgis_upgrade*.sql</filename> and <filename>topology_upgrade*.sql</filename> respectively. If you need them:
ja: ラスタ機能とトポロジ機能についても同じ手続きです。それぞれ<filename>rtpostgis_upgrade*.sql</filename>と<filename>topology_upgrade*.sql</filename>とになります。次のようにします。

note: Tag: programlisting
en: psql -f rtpostgis_upgrade.sql -d your_spatial_database
ja: psql -f rtpostgis_upgrade.sql -d [データベース名]

note: Tag: programlisting
en: psql -f topology_upgrade.sql -d your_spatial_database
ja: psql -f topology_upgrade.sql -d [データベース名]

note: Tag: para
en: If you can't find the <filename>postgis_upgrade*.sql</filename> specific for upgrading your version you are using a version too early for a soft upgrade and need to do a HARD UPGRADE.
ja: アップグレードのための特定の版の<filename>postgis_upgrade*.sql</filename>が見つからない場合は、非常に古い版を使っています。ハードアップグレードが必要です。

note: Tag: para
en: The <xref linkend="PostGIS_Full_Version"/> function should inform you about the need to run this kind of upgrade using a "procs need upgrade" message.
ja: <xref linkend="PostGIS_Full_Version"/>関数の"procs need upgrade"というメッセージで、この種のアップグレードを実行する必要性についての情報が得られます。

note: Tag: title
en: Soft Upgrade 9.1+ using extensions
ja: 9.1以上でエクステンションを使ったソフトアップグレード

note: Tag: para
en: If you originally installed PostGIS with extensions, then you need to upgrade using extensions as well. Doing a minor upgrade with extensions, is fairly painless.
ja: エクステンションを使ってPostGISをインストールした場合には、エクステンションを使ってアップグレードする必要があります。エクステンションを使ったマイナーアップグレードはかなり楽です。

note: Tag: para
en: If you get an error notice something like:
ja: 次のようなエラー通知が表示されることがあります。

note: Tag: para
en: Then you'll need to backup your database, create a fresh one as described in <xref linkend="create_new_db_extensions"/> and then restore your backup ontop of this new database.
ja: この場合は、データベースをバックアップして、<xref linkend="create_new_db_extensions"/>に記述されているように新しいデータベースを生成し、バックアップを新しいデータベースにリストアしなければなりません。

note: Tag: para
en: If you get a notice message like:
ja: 次のようなメッセージを得ることがあります。

note: Tag: para
en: Then everything is already up to date and you can safely ignore it. <emphasis role="bold">UNLESS</emphasis> you're attempting to upgrade from an SVN version to the next (which doesn't get a new version number); in that case you can append "next" to the version string, and next time you'll need to drop the "next" suffix again:
ja: この場合は、全てアップデートされていて、安全に無視できます。SVN版から次版(新しい版番号を得ていないもの)にアップグレード<emphasis role="bold">しようとしない限り</emphasis>、"next"を版文字列に追加できます。ただし、次回に"next"を削除する必要があります。

note: Tag: para
en: If you installed PostGIS originally without a version specified, you can often skip the reinstallation of postgis extension before restoring since the backup just has <code>CREATE EXTENSION postgis</code> and thus picks up the newest latest version during restore.
ja: PostGISをバージョン指定なしにインストールした場合には、 しばしばリストアの前のPostGIS EXTENSIONの再インストールをとばすことができます。 バックアップは<code>CREATE EXTENSION postgis</code>だけで、リストアの間に最新版になります。

note: Tag: title
en: Hard upgrade
ja: ハードアップグレード

note: Tag: para
en: By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You need a HARD UPGRADE when PostGIS objects' internal storage changes or when SOFT UPGRADE is not possible. The <link linkend="release_notes">Release Notes</link> appendix reports for each version whether you need a dump/reload (HARD UPGRADE) to upgrade.
ja: ハードアップグレードとは、PostGISで利用可能なデータの完全なダンプ/リロードを意味します。PostGISオブジェクトの内部格納状態が変更される場合や、ソフトアップグレードができない場合に、ハードアップグレードが必要です。付録の<link linkend="release_notes">リリースノート</link>に、版ごとについて、ダンプ/リロード (ハードアップグレード)の要否を記載しています。

note: Tag: para
en: The dump/reload process is assisted by the postgis_restore.pl script which takes care of skipping from the dump all definitions which belong to PostGIS (including old ones), allowing you to restore your schemas and data into a database with PostGIS installed without getting duplicate symbol errors or bringing forward deprecated objects.
ja: ダンプ/リロード作業はpostgis_restore.plスクリプトが補助します。このスクリプトは、PostGIS (古いものを含む)に属する定義を全て飛ばすように注意します。また、重複シンボルエラーや非推奨オブジェクトを持越すことなく、スキーマとデータをPostGISをインストールしたデータベースにリストアできます 。

note: Tag: para
en: Supplementary instructions for windows users are available at <ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</ulink>.
ja: Windows用に関する追加情報は<ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</ulink>にあります。

note: Tag: para
en: The Procedure is as follows:
ja: 手続きは次の通りです。

note: Tag: para
en: Create a "custom-format" dump of the database you want to upgrade (let's call it <varname>olddb</varname>) include binary blobs (-b) and verbose (-v) output. The user can be the owner of the db, need not be postgres super account.
ja: アップグレードしたデータベース (<varname>olddb</varname>と呼ぶことにしましょう)の「カスタム書式」のダンプを、バイナリBLOBデータを含めたダンプを指定して (-b)、verboseモード (-v)で生成します。ユーザはデータベースのオーナーになることができ、PostgreSQLのスーパーユーザである必要はありません。

note: Tag: para
en: Do a fresh install of PostGIS in a new database -- we'll refer to this database as <varname>newdb</varname>. Please refer to <xref linkend="create_new_db"/> and <xref linkend="create_new_db_extensions"/> for instructions on how to do this.
ja: 新しいデータベースにPostGISを、PostGISが無い状態からインストールします。このデータベースを<varname>newdb</varname>と呼ぶことにします。この作業に関する説明については<xref linkend="create_new_db"/>と<xref linkend="create_new_db_extensions"/>とを参照して下さい。

note: Tag: para
en: The spatial_ref_sys entries found in your dump will be restored, but they will not override existing ones in spatial_ref_sys. This is to ensure that fixes in the official set will be properly propagated to restored databases. If for any reason you really want your own overrides of standard entries just don't load the spatial_ref_sys.sql file when creating the new db.
ja: ダンプにあるspatial_ref_sysは、リストアされますが、既にあるspatial_ref_sysを上書きしません。リストア対象のデータベースに公式データセットの訂正が確実に伝わるようにするためです。標準のエントリを上書きしたい場合は、newdbを生成する際にspaltial_ref_sys.sqlファイルをロードしないだけです。

note: Tag: para
en: If your database is really old or you know you've been using long deprecated functions in your views and functions, you might need to load <filename>legacy.sql</filename> for all your functions and views etc. to properly come back. Only do this if _really_ needed. Consider upgrading your views and functions before dumping instead, if possible. The deprecated functions can be later removed by loading <filename>uninstall_legacy.sql</filename>.
ja: データベースが本当に古く、ビューや関数に、長く非推奨になっている関数があるような場合には、関数やビューを使えるようにするlegacy.sqlをロードする必要があるでしょう。ただし、本当に必要な場合に限ります。可能なら、ビューや関数をダンプせずにアップグレードすることを検討して下さい。非推奨関数は、<filename>uninstall_legacy.sql</filename>で後から削除することができます。

note: Tag: para
en: Restore your backup into your fresh <varname>newdb</varname> database using postgis_restore.pl. Unexpected errors, if any, will be printed to the standard error stream by psql. Keep a log of those.
ja: バックアップを新しい<varname>newdb</varname>データベースにリストアするには、postgis_restore.plを使います。psqlが予期せぬエラーを標準エラー出力に出すことがあります。これらのログを保存しておいて下さい。

note: Tag: para
en: Errors may arise in the following cases:
ja: エラーは次の場合に起こりえます。

note: Tag: para
en: Some of your views or functions make use of deprecated PostGIS objects. In order to fix this you may try loading <filename>legacy.sql</filename> script prior to restore or you'll have to restore to a version of PostGIS which still contains those objects and try a migration again after porting your code. If the <filename>legacy.sql</filename> way works for you, don't forget to fix your code to stop using deprecated functions and drop them loading <filename>uninstall_legacy.sql</filename>.
ja: ビューまたは関数の中に非推奨のPostGISオブジェクトを使っているものがある場合。これの訂正には、リストア前に<filename>legacy.sql</filename>スクリプトのロードを試してみることができます。非推奨オブジェクトをまだ持っている版のPostGISにリストアして、コードを作り替えた後に再び移動させることもできます。 <filename>legacy.sql</filename>を利用する場合は、非推奨関数を使うのをやめたコードに訂正して、<filename>uninstall_legacy.sql</filename>をロードするのを忘れないでください。

note: Tag: para
en: Some custom records of spatial_ref_sys in dump file have an invalid SRID value. Valid SRID values are bigger than 0 and smaller than 999000. Values in the 999000.999999 range are reserved for internal use while values > 999999 can't be used at all. All your custom records with invalid SRIDs will be retained, with those > 999999 moved into the reserved range, but the spatial_ref_sys table would lose a check constraint guarding for that invariant to hold and possibly also its primary key ( when multiple invalid SRIDS get converted to the same reserved SRID value ).
ja: ダンプファイル内のspatial_ref_sysにあるカスタムレコードが不正なSRIDになっていることがあります。妥当なSRID値は0より大きく999000より小さくなります。999000から999999の間は内部利用のための予約領域ですが、999999より大きい値は一切使用できません。全ての不正なSRIDを持つ独自レコードは、予約領域に移動しても保持されます。しかし、spatial_ref_sysテーブルから、値が保持されるように設定されているチェック制約が外れます。場合によっては (複数の不正なSRIDが同じ予約領域のSRID値に変換されるとき)、主キーも外れます。

note: Tag: para
en: In order to fix this you should copy your custom SRS to a SRID with a valid value (maybe in the 910000..910999 range), convert all your tables to the new srid (see <xref linkend="UpdateGeometrySRID"/>), delete the invalid entry from spatial_ref_sys and re-construct the check(s) with:
ja: これの訂正には、カスタムSRSを妥当値 (多分91000から910999の間になります)に複写して、全てのテーブルを新しいSRIDに変換して(<xref linkend="UpdateGeometrySRID"/>を参照して下さい)、不正なエントリをspatial_ref_sysから削除して、次を実行してチェック制約を再構築します。

note: Tag: title
en: Common Problems during installation
ja: 共通の問題

note: Tag: para
en: There are several things to check when your installation or upgrade doesn't go as you expected.
ja: インストールやアップグレードが思うようにいかない時にチェックすることがいくつかあります。

note: Tag: para
en: Check that you have installed PostgreSQL &min_postgres_version; or newer, and that you are compiling against the same version of the PostgreSQL source as the version of PostgreSQL that is running. Mix-ups can occur when your (Linux) distribution has already installed PostgreSQL, or you have otherwise installed PostgreSQL before and forgotten about it. PostGIS will only work with PostgreSQL &min_postgres_version; or newer, and strange, unexpected error messages will result if you use an older version. To check the version of PostgreSQL which is running, connect to the database using psql and run this query:
ja: PostgreSQL &min_postgres_version;以上をインストールしているか、実行中のPostgreSQLと同じ版のソースでコンパイルしているか、をチェックします。(Linuxの)ディストリビューションによって既にPostgreSQLがインストールされている時や、 PostgreSQLを以前にインストールして忘れた場合に、 混乱が発生することがあります。PostGISはPostgreSQL &min_postgres_version;以上で動作します。古い版のものを使った場合には、おかしな予想外のエラーメッセージが表示されます。実行中のPostgreSQLの版をチェックするには、psqlを使ってデータベースを接続して、次のクエリを実行して下さい。

note: Tag: para
en: If you are running an RPM based distribution, you can check for the existence of pre-installed packages using the <command>rpm</command> command as follows: <command>rpm -qa | grep postgresql</command>
ja: RPMベースのディストリビューションを実行している場合、 プリインストールされたパッケージが存在するかのチェックは、<command>rpm</command> コマンドを使って<command>rpm -qa | grep postgresql</command>でチェックできます。

note: Tag: para
en: If your upgrade fails, make sure you are restoring into a database that already has PostGIS installed.
ja: アップグレードに失敗する場合、既にPostGISがインストールされているデータベースにリストアしているか確認して下さい。

note: Tag: para
en: Also check that configure has correctly detected the location and version of PostgreSQL, the Proj4 library and the GEOS library.
ja: また、コンフィギュアが正しくPostgreSQL、Proj4ライブラリ、GEOSライブラリのインストール先を検出したかチェックして下さい。

note: Tag: para
en: The output from configure is used to generate the <filename>postgis_config.h</filename> file. Check that the <varname>POSTGIS_PGSQL_VERSION</varname>, <varname>POSTGIS_PROJ_VERSION</varname> and <varname>POSTGIS_GEOS_VERSION</varname> variables have been set correctly.
ja: コンフィギュアからの出力で<filename>postgis_config.h</filename>ファイルが作られます。<varname>POSTGIS_PGSQL_VERSION</varname>、<varname>POSTGIS_PROJ_VERSION</varname>および<varname>POSTGIS_GEOS_VERSION</varname>変数が正しくセットされたかをチェックして下さい。

note: Tag: title
en: Loader/Dumper
ja: ローダ/ダンパ

note: Tag: para
en: The data loader and dumper are built and installed automatically as part of the PostGIS build. To build and install them manually:
ja: データのローダとダンパは、PostGISのビルドの一部として、自動的にビルド、インストールされます。手動でビルド、インストールするには、次を実行します。

note: Tag: para
en: The loader is called <filename>shp2pgsql</filename> and converts ESRI Shape files into SQL suitable for loading in PostGIS/PostgreSQL. The dumper is called <filename>pgsql2shp</filename> and converts PostGIS tables (or queries) into ESRI Shape files. For more verbose documentation, see the online help, and the manual pages.
ja: ローダは<filename>shp2pgsql</filename>と呼ばれ、ESRIシェープファイルをPostGIS/PostgreSQLにロードするのに適したSQLに変換します。ダンパは<filename>pgsql2shp</filename>と呼ばれ、PostGISのテーブル(またはクエリ)からESRIシェープファイルに変換します。より詳しいドキュメントをご覧になるには、オンラインヘルプとマニュアルページをご覧ください。
