Sha256: ac27dcfeac2d3e1e13aa3a89d211d163ac408f83fc6a5da6a3904a89e2d1a479

Contents?: true

Size: 1.85 KB

Versions: 16

Compression:

Stored size: 1.85 KB

Contents

.. -*- rst -*-

.. highlightlang:: none

.. groonga-command
.. database: commands_object_exist

``object_exist``
================

Summary
-------

.. versionadded:: 5.0.6

``object_exist`` returns whether object with the specified name exists
or not in database.

It's a light operation. It just checks existence of the name in the
database. It doesn't load the specified object from disk.

``object_exist`` doesn't check object type. The existing object may be
table, column, function and so on.

Syntax
------

This command takes only one required parameter::

  object_exist name

Usage
-----

You can check whether the name is already used in database:

.. groonga-command
.. include:: ../../example/reference/commands/object_exist/usage.log
.. object_exist Users
.. table_create Users TABLE_HASH_KEY ShortText
.. object_exist Users

The ``object_exist Users`` returns ``false`` before we create
``Users`` table.

The ``object_exist Users`` returns ``true`` after we create ``Users``
table.

Parameters
----------

This section describes all parameters.

Required parameters
^^^^^^^^^^^^^^^^^^^

There is only one required parameters.

.. _object-exist-name:

``name``
""""""""

Specifies the object name to be checked.

If you want to check existence of a column, use
``TABLE_NAME.COLUMN_NAME`` format like the following:

.. groonga-command
.. include:: ../../example/reference/commands/object_exist/name_column.log
.. table_create Logs TABLE_NO_KEY
.. column_create Logs timestamp COLUMN_SCALAR Time
.. object_exist Logs.timestamp

``Logs`` is table name and ``timestamp`` is column name in
``Logs.timestamp``.

Return value
------------

The command returns ``true`` as body if object with the specified name
exists in database such as::

  [HEADER, true]

The command returns ``false`` otherwise such as::

  [HEADER, false]

See :doc:`/reference/command/output_format` for ``HEADER``.

Version data entries

16 entries across 8 versions & 1 rubygems

Version Path
rroonga-5.1.1-x86-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.1.1-x86-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.1.1-x64-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.1.1-x64-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.9-x86-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.9-x86-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.9-x64-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.9-x64-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.8-x86-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.8-x86-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.8-x64-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.8-x64-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.5-x86-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.5-x86-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.5-x64-mingw32 vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_exist.txt
rroonga-5.0.5-x64-mingw32 vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_exist.txt