1.2.1 - en to ja translation catalogue (108 entries)

en: Execution example::
ja: 実行例::

en: Summary
ja: 概要

en: ``table_create`` creates a new table in the current database. You need to create one or more tables to store and search data.
ja: ``table_create`` は現在のデータベースに新しいテーブルを作成します。データを保存したり検索したりするために、1つ以上のテーブルを作成する必要があります。

en: See :doc:`/reference/tables` for table details.
ja: テーブルの詳細は :doc:`/reference/tables` を見てください。

en: Syntax
ja: 構文

en: This command takes many parameters.
ja: このコマンドにはたくさんの引数があります。

en: The required parameter is only ``name`` and otehrs are optional::
ja: 必須の引数は ``name`` だけで、残りは省略できます::

en: Usage
ja: 使い方

en: This section describes about the followings:
ja: このセクションでは次のことについて説明します。

en: Create data store table
ja: データ保存用テーブルの作成

en: You can use all table types for data store table. See :doc:`/reference/tables` for all table types.
ja: データ保存用のテーブルにはどの種類のテーブルでも使えます。テーブルの種類については :doc:`/reference/tables` を参照してください。

en: Table type is specified as ``TABLE_${TYPE}`` to ``flags`` parameter.
ja: テーブルの型は ``TABLE_${TYPE}`` を ``flags`` 引数に指定します。

en: Here is an example to create ``TABLE_NO_KEY`` table:
ja: 以下は ``TABLE_NO_KEY`` テーブルを使う例です。

en: The ``table_create`` command creates a table that is named ``Logs`` and is ``TABLE_NO_KEY`` type.
ja: この ``table_create`` コマンドは ``Logs`` という名前で ``TABLE_NO_KEY`` 型のテーブルを作成します。

en: If your records aren't searched by key, ``TABLE_NO_KEY`` type table is suitable. Because ``TABLE_NO_KEY`` doesn't support key but it is fast and small table. Storing logs into Groonga database is the case.
ja: キーでレコードを検索しないのであれば、 ``TABLE_NO_KEY`` 型のテーブルが適切です。なぜなら、 ``TABLE_NO_KEY`` はキーをサポートしていませんが、速くて小さいサイズのテーブルだからです。ログをGroongaのデータベースに保存するという使い方はこのケースです。

en: If your records are searched by key or referenced by one or more columns, ``TABLE_NO_KEY`` type isn't suitable. Lexicon for fulltext search is the case.
ja: キーでレコードを検索したり、カラムからレコードを参照したりする場合は、 ``TABLE_NO_KEY`` 型は適していません。全文検索用の語彙表として使うケースはこのケースです。

en: Create large data store table
ja: 大きなデータ保存用テーブルの作成

en: If you want to store many large keys, your table may not be able to store them. If total key data is larger than 4GiB, you can't store all key data into your table by default.
ja: たくさんの大きなキーを保存したいとき、テーブルにすべてのキーを保存できないかもしれません。もし、総キーデータが4GiBより大きいなら、デフォルトではすべてのキーデータをテーブルに保存できません。

en: You can expand the maximum total key size to 1TiB from 4GiB by ``KEY_LARGE`` flag. ``KEY_LARGE`` flag can be used with only ``TABLE_HASH_KEY``. You can't use ``KEY_LARGE`` flag with ``TABLE_NO_KEY``, ``TABLE_PAT_KEY`` nor ``TABLE_DAT_KEY``.
ja: ``KEY_LARGE`` フラグを使うと4GiBから1TiBに最大総キーサイズを拡張できます。 ``KEY_LARGE`` フラグは ``TABLE_HASH_KEY`` を使っているときだけ使えます。 ``KEY_LARGE`` フラグは ``TABLE_NO_KEY`` 、 ``TABLE_PAT_KEY`` 、 ``TABLE_DAT_KEY`` と一緒に使えません。

en: Here is an example to create a table that can store many large keys:
ja: 以下はたくさんの大きなキーを保存することができるテーブルを作る例です。

en: The ``table_create`` command creates a table that is named ``Paths`` and is ``TABLE_HASH_KEY`` type. The ``Paths`` table can store many large keys.
ja: この ``table_create`` コマンドは、名前が ``Paths`` で ``TABLE_HASH_KEY`` 型のテーブルを作成します。 ``Paths`` テーブルはたくさんの大きなキーを保存できます。

en: Create lexicon
ja: 語彙表の作成

en: You can use all table types except ``TABLE_NO_KEY`` for lexicon. Lexicon needs key support but ``TABLE_NO_KEY`` doesn't support key.
ja: 語彙表用のテーブルには ``TABLE_NO_KEY`` 以外の型のテーブルを使います。語彙表はキーをサポートしていないといけませんが、 ``TABLE_NO_KEY`` はキーをサポートしていません。

en: Here is an example to create ``TABLE_PAT_KEY`` table:
ja: 以下は ``TABLE_PAT_KEY`` テーブルを作る例です。

en: The ``table_create`` command creates the following table:
ja: この ``table_create`` コマンドは以下のテーブルを作成します。

en: The table is named ``Lexicon``.
ja: このテーブルは ``Lexicon`` という名前です。

en: The table is ``TABLE_PAT_KEY`` type table.
ja: このテーブルは ``TABLE_PAT_KEY`` 型のテーブルです。

en: The table's key is ``ShortText`` type.
ja: このテーブルのキーは ``ShortText`` 型です。

en: The table uses ``TokenBigram`` tokenizer to extract tokens from a normalized text.
ja: このテーブルは正規化されたテキストからトークンを抽出するために ``TokenBigram`` トークナイザーを使います。

en: The table uses ``NormalizerAuto`` normalizer to normalize a text.
ja: このテーブルはテキストを正規化するために ``NormalizerAuto`` ノーマライザーを使います。

en: ``TABLE_PAT_KEY`` is suitable table type for lexicon. Lexicon is used for fulltext search.
ja: 語彙表には ``TABLE_PAT_KEY`` が適切なテーブルの型です。語彙表は全文検索に使われます。

en: In fulltext search, predictive search may be used for fuzzy search. Predictive search is supported by ``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY``.
ja: 全文検索では、あいまい検索をするために前方一致検索を使っています。前方一致検索は ``TABLE_PAT_KEY`` と ``TABLE_DAT_KEY`` がサポートしています。

en: Lexicon has many keys because a fulltext target text has many tokens. Table that has many keys should consider table size because large table requires large memory. Requiring large memory causes disk I/O. It blocks fast search. So table size is important for a table that has many keys. ``TABLE_PAT_KEY`` is less table size than ``TABLE_DAT_KEY``.
ja: 全文検索対象のテキストには大量のトークンが含まれるので、語彙表のキーも大量になります。大量のキーを格納するテーブルの場合はテーブルのサイズを意識する必要があります。これは、大きなテーブルはそれだけ多くのメモリーを必要とするからです。多くのメモリーが必要になると、ディスクI/Oが発生することもあります。ディスクI/Oが発生すると高速に検索できなくなります。そのため、大量のキーがあるテーブルの場合はテーブルのサイズが重要になります。 ``TABLE_PAT_KEY`` は ``TABLE_DAT_KEY`` よりもテーブルのサイズが小さいです。

en: Because of the above reasons, ``TABLE_PAT_KEY`` is suitable table type for lexicon.
ja: 上記の理由から、 ``TABLE_PAT_KEY`` が語彙表に適したテーブルの型です。

en: Create tag index table
ja: タグインデックス用テーブルの作成

en: You can use all table types except ``TABLE_NO_KEY`` for tag index table. Tag index table needs key support but ``TABLE_NO_KEY`` doesn't support key.
ja: タグインデックス用のテーブルには ``TABLE_NO_KEY`` 以外の型のテーブルを使えます。タグインデックス用のテーブルはキーのサポートが必要ですが、 ``TABLE_NO_KEY`` はキーをサポートしていません。

en: Here is an example to create ``TABLE_HASH_KEY`` table:
ja: 以下は ``TABLE_HASH_KEY`` 型のテーブルを作る例です。

en: The ``table_create`` command creates a table that is named ``Tags``, is ``TABLE_HASH_KEY`` type and has ``ShortText`` type key.
ja: この ``table_create`` コマンドは ``Tags`` という名前で ``TABLE_HASH_KEY`` 型のテーブルを作ります。このテーブルのキーは ``ShortText`` 型です。

en: ``TABLE_HASH_KEY`` or ``TABLE_DAT_KEY`` are suitable table types for tag index table.
ja: タグインデックス用のテーブルには ``TABLE_HASH_KEY`` あるいは ``TABLE_DAT_KEY`` が適切なテーブルの型です。

en: If you need only exact match tag search feature, ``TABLE_HASH_KEY`` is suitable. It is the common case.
ja: 完全一致でタグを検索する機能だけが必要なら、 ``TABLE_HASH_KEY`` が適切です。多くの場合はこのケースです。

en: If you also need predictive tag search feature (for example, searching ``"groonga"`` by ``"gr"`` keyword.), ``TABLE_DAT_KEY`` is suitable. ``TABLE_DAT_KEY`` is large table size but it is not important because the number of tags will not be large.
ja: もし、前方一致検索機能も必要な場合（例えば、 ``"gr"`` というキーワードで ``"groonga"`` を検索する場合）は、 ``TABLE_DAT_KEY`` が適切です。 ``TABLE_DAT_KEY`` はサイズの大きなテーブルですが、タグの数はそれほど多くならないので、サイズは重要ではありません。

en: Create range index table
ja: 範囲検索用のインデックステーブルの作成

en: You can use ``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY`` table types for range index table. Range index table needs range search support but ``TABLE_NO_KEY`` and ``TABLE_HASH_KEY`` don't support it.
ja: 範囲検索用のインデックステーブルには ``TABLE_PAT_KEY`` 型と ``TABLE_DAT_KEY`` 型を使えます。範囲検索用のインデックステーブルは範囲検索をサポートしている必要がありますが、 ``TABLE_NO_KEY`` 型と ``TABLE_HASH_KEY`` 型はサポートしていません。

en: Here is an example to create ``TABLE_DAT_KEY`` table:
ja: 以下は ``TABLE_DAT_KEY`` テーブルを作成する例です。

en: The ``table_create`` command creates a table that is named ``Ages``, is ``TABLE_DAT_KEY`` type and has ``UInt32`` type key.
ja: この ``table_create`` コマンドは ``Ages`` という名前で ``TABLE_DAT_KEY`` 型のテーブルを作成します。このテーブルのキーの型は ``UInt32`` です。

en: ``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY`` are suitable table types for range index table.
ja: 範囲検索用のインデックステーブルには ``TABLE_PAT_KEY`` 型と ``TABLE_DAT_KEY`` 型が適切なテーブルの型です。

en: If you don't have many indexed items, ``TABLE_DAT_KEY`` is suitable. Index for age is the case in the above example. Index for age will have only 0-100 items because human doesn't live so long.
ja: インデックス対象の項目が少なければ、 ``TABLE_DAT_KEY`` 型が適切です。前述の例では、年齢（age）用のインデックスがこのケースになります。年齢のインデックスはせいぜい0から100項目くらいにしかなりません。これは、人はそんなに長生きできないからです。

en: If you have many indexed items, ``TABLE_PAT_KEY`` is suitable. Because ``TABLE_PAT_KEY`` is smaller than ``TABLE_DAT_KEY``.
ja: インデックス対象が大量にある場合は、 ``TABLE_PAT_KEY`` 型が適切です。なぜなら、 ``TABLE_PAT_KEY`` 型は ``TABLE_DAT_KEY`` 型よりもサイズが小さいからです。

en: Parameters
ja: 引数

en: This section describes all parameters.
ja: このセクションではすべての引数について説明します。

en: Required parameters
ja: 必須引数

en: There is only one required parameter.
ja: 必須の引数は1つです。

en: Specifies a table name to be created. ``name`` must be specified.
ja: 作成するテーブル名を指定します。 ``name`` は必ず指定しなければいけません。

en: Here are available characters:
ja: 利用可能な文字は以下の通りです。

en: ``0`` .. ``9`` (digit)
ja: ``0`` .. ``9`` （数字）

en: ``a`` .. ``z`` (alphabet, lower case)
ja: ``a`` .. ``z`` （アルファベット。小文字）

en: ``A`` .. ``Z`` (alphabet, upper case)
ja: ``A`` .. ``Z`` （アルファベット。大文字）

en: ``#`` (hash)
ja: ``#`` （シャープ）

en: ``@`` (at mark)
ja: ``@`` （アットマーク）

en: ``-`` (hyphen)
ja: ``-`` （ハイフン）

en: ``_`` (underscore) (NOTE: Underscore can't be used as the first character.)
ja: ``_`` （アンダースコア）（注: 最初の文字としてアンダースコアを使うことはできません。）

en: You need to create a name with one or more the above characters. Note that you can't use ``_`` as the first character such as ``_name``.
ja: 上記の文字を1つ以上使って名前を決めます。 ``_name`` というように、最初の文字に ``_`` を使えないことに注意してください。

en: Optional parameters
ja: 省略可能引数

en: There are some optional parameters.
ja: いくつか省略可能な引数があります。

en: Specifies a table type and table customize options.
ja: テーブルの型とテーブルをカスタマイズするオプションを指定します。

en: Here are available flags:
ja: 指定可能なフラグは以下の通りです。

en: Flag
ja: フラグ

en: Description
ja: 説明

en: Array table. See also :ref:`table-no-key`.
ja: 配列テーブル。 :ref:`table-no-key` 参照。

en: Hash table. See also :ref:`table-hash-key`.
ja: ハッシュテーブル。 :ref:`table-hash-key` 参照。

en: Patricia trie. See also :ref:`table-pat-key`.
ja: パトリシアトライ。 :ref:`table-pat-key` 参照。

en: Double array trie. See also :ref:`table-dat-key`.
ja: ダブル配列トライ。 :ref:`table-dat-key` 参照。

en: Enable Semi Infinite String. Require ``TABLE_PAT_KEY``.
ja: 半無限文字列を有効にします。 ``TABLE_PAT_KEY`` と使う必要があります。

en: Expand the maximum total key size to 1TiB from 4GiB. Require ``TABLE_HASH_KEY``.
ja: 最大総キーサイズを4GiBから1TiBへ拡張します。 ``TABLE_HASH_KEY`` と使う必要があります。

en: Since Groonga 2.1.0 ``KEY_NORMALIZE`` flag is deprecated. Use ``normalizer`` option with ``NormalizerAuto`` instead.
ja: Groonga 2.1.0から ``KEY_NORMALIZE`` フラグは非推奨になりました。代わりに、 ``normalizer`` オプションに ``NormalizerAuto`` を指定してください。

en: You must specify one of ``TABLE_${TYPE}`` flags. You can't specify two or more ``TABLE_${TYPE}`` flags. For example, ``TABLE_NO_KEY|TABLE_HASH_KEY`` is invalid.
ja: ``TABLE_${TYPE}`` フラグのどれか1つを指定します。 ``TABLE_${TYPE}`` フラグを2つ以上指定することはできません。例えば、 ``TABLE_NO_KEY|TABLE_HASH_KEY`` は不正な指定方法です。

en: You can combine flags with ``|`` (vertical bar) such as ``TABLE_PAT_KEY|KEY_WITH_SIS``.
ja: ``TABLE_PAT_KEY|KEY_WITH_SIS`` というように、 ``|`` （縦棒）で複数のフラグを組み合わせることができます。

en: See :doc:`/reference/tables` for difference between table types.
ja: それぞれのテーブルの型の違いは :doc:`/reference/tables` を参照してください。

en: The default flags are ``TABLE_HASH_KEY``.
ja: デフォルトのフラグは ``TABLE_HASH_KEY`` です。

en: Specifies key type.
ja: キーの型を指定します。

en: If you specify ``TABLE_HASH_KEY``, ``TABLE_PAT_KEY`` or ``TABLE_DAT_KEY`` as ``flags`` parameter, you need to specify ``key_type`` option.
ja: ``flags`` パラメーターに ``TABLE_HASH_KEY`` 、 ``TABLE_PAT_KEY`` または ``TABLE_DAT_KEY`` を指定した場合は、 ``key_type`` オプションを指定する必要があります。

en: See :doc:`/reference/types` for all types.
ja: 型の一覧は :doc:`/reference/types` にあります。

en: The default value is none.
ja: デフォルト値はありません。

en: Specifies value type.
ja: 値の型を指定します。

en: You can use value when you specify ``TABLE_NO_KEY``, ``TABLE_HASH_KEY`` or ``TABLE_PAT_KEY`` as ``flags`` parameter. Value type must be a fixed size type. For example, ``UInt32`` can be used but ``ShortText`` cannot be used. Use columns instead of value.
ja: ``flags`` パラメーターに ``TABLE_NO_KEY`` 、 ``TABLE_HASH_KEY`` または ``TABLE_PAT_KEY`` を指定した場合は「値」を使うことができます。「値」の型は固定長でなければいけません。例えば、 ``UInt32`` は使えますが、 ``ShortText`` は使えません。この場合は値ではなく、カラムを使ってください。

en: Specifies the default tokenizer that is used on searching and data loading.
ja: デフォルトトークナイザーを指定します。これは、検索時とデータロード時に使われます。

en: You must specify ``default_tokenizer`` for a table that is used for lexicon of fulltext search index. See :doc:`/reference/tokenizers` for available tokenizers. You must choose a tokenizer from the list for fulltext search.
ja: テーブルを全文検索インデックスの語彙表として使う場合は ``default_tokenizer`` を指定しなければいけません。利用可能なトークナイザーは :doc:`/reference/tokenizers` を参照してください。全文検索する場合はこのリストの中からトークナイザーを選んでください。

en: You don't need to specify ``default_tokenizer`` in the following cases:
ja: 次の場合は ``default_tokenizer`` を指定する必要はありません。

en: You don't use the table as a lexicon.
ja: テーブルを語彙表として使わないとき。

en: You use the table as a lexicon but you don't need fulltext search. For example:
ja: テーブルを語彙表として使うが、全文検索をしないとき。例：

en: Index target data isn't text data such as ``Int32`` and ``Time``.
ja: インデックス対象のデータが ``Int32`` や ``Time`` のようにテキストデータでないとき。

en: You just need exact match search, prefix search and so on.
ja: 完全一致検索や前方一致検索などだけが必要なとき。

en: You can't use ``default_tokenizer`` with ``TABLE_NO_KEY`` flag because a table that uses ``TABLE_NO_KEY`` flag can't be used as lexicon.
ja: ``TABLE_NO_KEY`` フラグと一緒に ``default_tokenizer`` を使うことはできません。これは、 ``TABLE_NO_KEY`` フラグを使っているテーブルは語彙表として使うことはできないからです。

en: You must specify ``TABLE_HASH_KEY``, ``TABLE_PAT_KEY``, ``TABLE_DAT_KEY`` to :ref:`table-create-flags` when you want to use the table as a lexicon.
ja: テーブルを語彙表として使いたいときは、 :ref:`table-create-flags` に ``TABLE_HASH_KEY`` 、 ``TABLE_PAT_KEY`` 、 ``TABLE_DAT_KEY`` のどれかを指定してください。

en: Specifies a normalizer that is used to normalize key.
ja: キーを正規化するために使うノーマライザーを指定します。

en: You cannot use ``normalizer`` with ``TABLE_NO_KEY`` because ``TABLE_NO_KEY`` doesn't support key.
ja: ``TABLE_NO_KEY`` はキーをサポートしていないので、 ``TABLE_NO_KEY`` と ``normalizer`` を一緒に指定することはできません。

en: See :doc:`/reference/normalizers` for all normalizsers.
ja: ノーマライザーの一覧は :doc:`/reference/normalizers` にあります。

en: Specifies token filters separated by ``,``. Token filters are used to process tokens.
ja: トークンフィルターを「,」（カンマ）区切りで指定します。トークンフィルターはトークンに所定の処理を行うために使われます。

en: You cannot use ``token_filters`` with ``TABLE_NO_KEY`` because ``TABLE_NO_KEY`` doesn't support key.
ja: ``TABLE_NO_KEY`` はキーをサポートしていないので、 ``TABLE_NO_KEY`` と ``token_filters`` を一緒に指定することはできません。

en: See :doc:`/reference/token_filters` for all token filters.
ja: トークンフィルターの一覧は :doc:`/reference/token_filters` にあります。

en: Specifies a path for storing a table.
ja: テーブルを格納するパスを指定します。

en: This option is useful if you want to store a table that you often use to fast storage (e.g. SSD) and store it that you don't often use to slow storage (e.g. HDD).
ja: このオプションは、高速なストレージ(SSDなど)によく使うテーブルを格納し、低速なストレージ(HDDなど)にあまり使わないテーブルを格納したいときに有用です。

en: You can use a relative path or an absolute path in this option. If you specify a relative path, it is resolved from the current directory for the ``groonga`` process.
ja: このオプションでは、絶対パスまたは相対パスを使えます。相対パスを指定した場合は、 ``groonga`` プロセスのカレントディレクトリーからパスを解決します。

en: Return value
ja: 戻り値

en: ``table_create`` returns ``true`` as body on success such as::
ja: ``table_create`` が成功したときは以下のようにボディは ``true`` になります::

en: If ``table_create`` fails, error details are in ``HEADER``.
ja: ``table_create`` が失敗すると、エラーの詳細は ``HEADER`` に含まれます。

en: See :doc:`/reference/command/output_format` for ``HEADER``.
ja: ``HEADER`` については :doc:`/reference/command/output_format` を参照してください。

en: See also
ja: 参考
