Difference between revisions of "LOCK TABLE"

From Lianjapedia
Jump to: navigation, search
 
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
 
Locks a table to control access by other processes
 
Locks a table to control access by other processes
 
  
 
==Syntax==
 
==Syntax==
 
LOCK TABLE [<database>!]&#060;table&#062; IN SHARE | EXCLUSIVE MODE [NOWAIT]
 
LOCK TABLE [<database>!]&#060;table&#062; IN SHARE | EXCLUSIVE MODE [NOWAIT]
 
  
 
==See Also==
 
==See Also==
 
[[COPY DATABASE]], [[CREATE DATABASE]], [[DISPLAY SCHEMAS]], [[SQL INSERT|INSERT]], [[LIST SCHEMAS]], [[OPEN DATABASE]], [[SQL SELECT|SELECT]], [[SET AUTOCATALOG]], [[SQL UPDATE|UPDATE]], [[SQL USE|USE]]
 
[[COPY DATABASE]], [[CREATE DATABASE]], [[DISPLAY SCHEMAS]], [[SQL INSERT|INSERT]], [[LIST SCHEMAS]], [[OPEN DATABASE]], [[SQL SELECT|SELECT]], [[SET AUTOCATALOG]], [[SQL UPDATE|UPDATE]], [[SQL USE|USE]]
 
  
 
==Description==
 
==Description==
 
To lock tables to control access by other processes. The LOCK TABLE statement locks an entire table to restrict access by other users or transactions.  There are no prerequisites required to perform this operation.
 
To lock tables to control access by other processes. The LOCK TABLE statement locks an entire table to restrict access by other users or transactions.  There are no prerequisites required to perform this operation.
  
 
+
{| class="wikitable" width="100%"
{| class="wikitable"
+
!width="20%"|Keywords||Description
!Keywords||Description
+
 
|-
 
|-
|database||The name of the database to which the table belongs.  Databases in Recital are implemented as directories containing files that correspond to the tables and associated files in the database.  Operating System file protection can be applied individually to the files for added security.  The directory is a sub-directory of the Recital data directory.  The environment variable / symbol DB_DATADIR points to the current Recital data directory and can be queried using the GETENV() function.  Files from other directories can be added to the database using the ADD TABLE command or via the database catalog and SET AUTOCATALOG functionality.  The '!' character must be included between the database name and the table name.
+
|valign="top"|database||The name of the database to which the table belongs.  The '!' character must be included between the database name and the table name.
 
|-
 
|-
 
|table||The name of the table to set the lock mode on.
 
|table||The name of the table to set the lock mode on.
 
|-
 
|-
|SHARE||Share locks allow queries on locked tables, but prevent updates.
+
|valign="top"|SHARE||Share locks allow queries on locked tables, but prevent updates.
 
|-
 
|-
 
|EXCLUSIVE||This lock denies access by any other process to the table
 
|EXCLUSIVE||This lock denies access by any other process to the table
 
|-
 
|-
|NOWAIT||This specifies that if a lock cannot be granted immediately during an update, then an error should be returned.
+
|valign="top"|NOWAIT||This specifies that if a lock cannot be granted immediately during an update, then an error should be returned.
 
|-
 
|-
 
|}
 
|}
 
  
 
==Example==
 
==Example==
Line 35: Line 30:
 
LOCK TABLE staff IN SHARE MODE
 
LOCK TABLE staff IN SHARE MODE
 
</code>
 
</code>
 
+
 
+
==Products==
+
Recital Server, Recital
+
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:SQL]]
 
[[Category:SQL]]
 
[[Category:Commands]]
 
[[Category:Commands]]
[[Category:Manual Locking]]
+
[[Category:Cursor Functions]]
 
[[Category:Databases]]
 
[[Category:Databases]]

Latest revision as of 07:48, 4 February 2013

Purpose

Locks a table to control access by other processes

Syntax

LOCK TABLE [<database>!]<table> IN SHARE | EXCLUSIVE MODE [NOWAIT]

See Also

COPY DATABASE, CREATE DATABASE, DISPLAY SCHEMAS, INSERT, LIST SCHEMAS, OPEN DATABASE, SELECT, SET AUTOCATALOG, UPDATE, USE

Description

To lock tables to control access by other processes. The LOCK TABLE statement locks an entire table to restrict access by other users or transactions. There are no prerequisites required to perform this operation.

Keywords Description
database The name of the database to which the table belongs. The '!' character must be included between the database name and the table name.
table The name of the table to set the lock mode on.
SHARE Share locks allow queries on locked tables, but prevent updates.
EXCLUSIVE This lock denies access by any other process to the table
NOWAIT This specifies that if a lock cannot be granted immediately during an update, then an error should be returned.

Example

LOCK TABLE staff IN SHARE MODE