<!--
$Header: /usr/prj/pg/cvsroot/doc/doc/src/sgml/ref/grant.sgml,v 1.6 2001/09/07 11:33:19 i-kaori Exp $
Postgres documentation
-->

<refentry id="SQL-GRANT">
 <refmeta>
  <refentrytitle id="SQL-GRANT-TITLE">
   GRANT
  </refentrytitle>
  <refmiscinfo>SQL<!-- Language Statements -->言語</refmiscinfo>
 </refmeta>
 <refnamediv>
  <refname>
   GRANT
  </refname>
  <refpurpose>
   <!-- Grants access privilege to a user, a group or all users -->
   ユーザー、グループ、すべてのユーザーにアクセス権限を付与します。<indexterm><primary>GRANT</primary></indexterm><indexterm><primary>SQL</primary><secondary>GRANT</secondary></indexterm><indexterm><primary sortas="けんげん">権限</primary></indexterm><indexterm><primary sortas="ゆーざー">ユーザー</primary><secondary sortas="けんげん">権限</secondary><tertiary sortas="ふよ">付与</tertiary></indexterm><indexterm><primary sortas="ぐるーぷ">グループ</primary><secondary sortas="けんげん">権限</secondary><tertiary sortas="ふよ">付与</tertiary></indexterm>
 
  </refpurpose>
 </refnamediv>
 <refsynopsisdiv>
  <refsynopsisdivinfo>
   <date>1999-07-20</date>
  </refsynopsisdivinfo>
<synopsis>
GRANT <replaceable class="PARAMETER">privilege</replaceable> [, ...] ON <replaceable class="PARAMETER">object</replaceable> [, ...]
    TO { PUBLIC | GROUP <replaceable class="PARAMETER">group</replaceable> | <replaceable class="PARAMETER">username</replaceable> }
</synopsis>
    
  <refsect2 id="R2-SQL-GRANT-1">
   <refsect2info>
    <date>1998-09-23</date>
   </refsect2info>
   <title>
    <!-- Inputs -->入力
   </title>

    <variablelist>
     <varlistentry>
      <term><replaceable class="PARAMETER">privilege</replaceable></term>
      <listitem>
       <para>
	<!-- The possible privileges are: -->
        付与する権限です。設定可能な権限は以下のものです。 
</para>

	<variablelist>
	 <varlistentry>
	  <term>SELECT</term>
	  <listitem>
	   <para>
	    <!-- Access all of the columns of a specific
	    table/view. -->

            特定のテーブル/ビューのすべての列にアクセスする権限。

	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>INSERT</term>
	  <listitem>
	   <para>
	    <!-- Insert data into all columns of a
	    specific table. -->

            特定のテーブル内のすべての列にデータを挿入する権限。

	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>UPDATE</term>
	  <listitem>
	   <para>
	    <!-- Update all columns of a specific
	    table. -->

            特定のテーブルのすべての列の更新を行う権限。

	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>DELETE</term>
	  <listitem>
	   <para>
	    <!-- Delete rows from a specific table. -->
            特定のテーブルの行を削除する権限。

	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>RULE</term>
	  <listitem>
	   <para>
	    <!-- Define rules on the table/view
	    (See CREATE RULE statement). -->

            テーブル/ビューにルールを設定する権限（<xref linkend="sql-createrule" endterm="sql-createrule-title">を参照してください）。

	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>ALL</term>
	  <listitem>
	   <para>
	    <!-- Grant all privileges. -->
            すべての権限を与えます。
	   </para>
	  </listitem>
	 </varlistentry>
	</variablelist>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><replaceable class="PARAMETER">object</replaceable></term>
      <listitem>
       <para>
	<!-- The name of an object to which to grant access.
	The possible objects are: -->

         アクセス権限を与えるオブジェクトの名前です。使用可能なオブジェクトは以下のものです。 
</para>

	<itemizedlist spacing="compact" mark="bullet">
	 <listitem>
	  <para>
	   <!-- table -->
           テーブル（table）
	  </para>
	 </listitem>

	 <listitem>
	  <para>
	   <!-- view -->
           ビュー（view）
	  </para>
	 </listitem>

	 <listitem>
	  <para>             
	   <!-- sequence -->
           シーケンス（sequence）
	  </para>
	 </listitem>

	</itemizedlist>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>PUBLIC</term>
      <listitem>
       <para>
	<!-- A short form representing all users. -->
        すべてのユーザーを意味する短縮形です。 

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term>GROUP <replaceable class="PARAMETER">group</replaceable></term>
      <listitem>
       <para>
        <!-- 
	A <replaceable class="PARAMETER">group</replaceable> to whom to 
        grant privileges. -->

        権限を与えるグループ名です。

       </para>
      </listitem>
     </varlistentry>	

     <varlistentry>
      <term>
       <replaceable class="PARAMETER">username</replaceable>
      </term>
      <listitem>
       <para>
        <!-- 
	The name of a user to whom to grant privileges. PUBLIC is a short form
	representing all users. -->

        権限を与えるユーザー名です。PUBLICはすべてのユーザーを表現する短縮形です。<indexterm><primary>PUBLIC</primary></indexterm><indexterm><primary sortas="ゆーざー">ユーザー</primary><secondary sortas="けんげん">権限</secondary><tertiary>PUBLIC</tertiary></indexterm>


       </para>
      </listitem>
     </varlistentry>	
    </variablelist>
  </refsect2>

  <refsect2 id="R2-SQL-GRANT-2">
   <refsect2info>
    <date>1998-09-23</date>
   </refsect2info>
   <title>
    <!-- Outputs -->出力
   </title>

    <variablelist>
     <varlistentry>
      <term><computeroutput>
CHANGE
       </computeroutput></term>
      <listitem>
       <para>
	<!-- Message returned if successful. -->
        成功した場合に返されるメッセージです。 

       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><computeroutput>
ERROR:  ChangeAcl: class "<replaceable class="PARAMETER">object</replaceable>" not found
       </computeroutput></term>
      <listitem>
       <para>
        <!-- 
	Message returned if the specified object is not available or 
	if it is impossible
	to give privileges to the specified group or users. -->

        指定したオブジェクトが利用できない、あるいは指定したグループまたはユーザーに対して権限を与えることができない場合に返されるメッセージです。 

       </para>
      </listitem>
     </varlistentry>	
    </variablelist>
  </refsect2>
 </refsynopsisdiv>

 <refsect1 id="R1-SQL-GRANT-1">
  <refsect1info>
   <date>1998-09-23</date>
  </refsect1info>
  <title>
   <!-- Description -->説明
  </title>

  <para>
   <!--   
   <command>GRANT</command> allows the creator of an object to give 
   specific permissions to all users (PUBLIC) or to a certain user or group. 
   Users other than the creator don't have any access permission 
   unless the creator GRANTs permissions, after the object
   is created. -->

   <command>GRANT</command>は、オブジェクトの作成者にすべてのユーザー（PUBLIC）、あるいはいくつかのユーザーまたはグループに対し、特定の権限を与えます。作成者以外のユーザーは、作成者がオブジェクトを作成後、権限をGRANTで与えない限り、どんなアクセス権限も持っていません。

  </para>

  <para>
   <!-- 
   Once a user has a privilege on an object, he is enabled to exercise
   that privilege.
   There is no need to GRANT privileges to the creator of 
   an object, the creator automatically holds ALL privileges, and can 
   also drop the object. -->

   いったんユーザーがオブジェクトに限権を所有すると、ユーザーはその権限を行使することができるようになります。オブジェクトの作成者には権限を与える必要はありません。作成者は自動的にすべての権限が与えられていて、さらにそのオブジェクトを削除することもできます。

  </para>

  <refsect2 id="R2-SQL-GRANT-3">
   <refsect2info>
    <date>1998-09-23</date>
   </refsect2info>
   <title>
    <!-- Notes -->注釈
   </title>

   <para>
    <!-- 
    Currently, to grant privileges in <productname>Postgres</productname>
    to only a few columns, you must
    create a view having desired columns and then grant privileges
    to that view. -->

    現在は、<productname>Postgres</productname>のいくつかのカラムだけに権限を与えるためには、対象となるカラムを持つビューを作成してから、そのビューに対して権限を与えなくてはなりません。 

   </para>

   <para>
    <!-- Use <command>psql &bsol;z</command>
    for further information about permissions 
    on existing objects: -->

    既存のオブジェクトに対する権限についての詳しい情報を知るには<command>psql &bsol;z</command>を使います。
</para>

<programlisting>
	  Database    = lusitania
   +------------------+---------------------------------------------+
   |  Relation        |           Access permissions                |
   +------------------+---------------------------------------------+
   | mytable          | {"=rw","miriam=arwR","group todos=rw"}      |
   +------------------+---------------------------------------------+
   Legend:
         uname=arwR -- privileges granted to a user
                      （ユーザーに与えられた権限）
   group gname=arwR -- privileges granted to a GROUP
                      （グループに与えられた権限）
              =arwR -- privileges granted to PUBLIC
                      （PUBLIC――すべてのユーザーに与えられた権限）

                  r -- SELECT
                  w -- UPDATE/DELETE
                  a -- INSERT
                  R -- RULE
               arwR -- ALL
</programlisting>

       <!--［訳注：上記の表では「Grant/Revoke Permissions」となっていますが、現在は「Access permissions」となっています。］-->

   <para>
    <!-- Refer to REVOKE statements to revoke access privileges. -->
    アクセス権限を撤回するには、REVOKE文を参照してください。 

   </para>
  </refsect2>
 </refsect1>

 <refsect1 id="R1-SQL-GRANT-2">
  <title>
   <!-- Usage -->使用方法
  </title>
  <para>
   <!-- 
   Grant insert privilege to all users on table films: -->

   テーブルfilmsにデータを追加する権限をすべてのユーザーに与えるには以下のようにします。 
</para>

<programlisting>
GRANT INSERT ON films TO PUBLIC;
</programlisting>

  <para>
   <!-- 
   Grant all privileges to user manuel on view kinds: -->

   ビューkindsのすべての権限を、ユーザーmanuelに与えるには以下のようにします。
</para>

<programlisting>
GRANT ALL ON kinds TO manuel;
</programlisting>
 </refsect1>

 <refsect1 id="R1-SQL-GRANT-3">
  <title>
   <!-- Compatibility -->互換性
  </title>
    
  <refsect2 id="R2-SQL-GRANT-4">
   <refsect2info>
    <date>1998-09-23</date>
   </refsect2info>
   <title>
    SQL92
   </title>
   <para>
    <!-- 
    The <acronym>SQL92</acronym> syntax for GRANT allows setting privileges 
    for individual columns
    within a table, and allows setting a privilege to grant
    the same privileges to others: -->

    <acronym>SQL92</acronym>の文法では、GRANTはテーブル中の個々の列に対して権限を設定すること、そして権限を与えられたユーザーが同じ権限を他のユーザーに与えることを許可しています。
</para>

<synopsis>
GRANT <replaceable class="PARAMETER">privilege</replaceable> [, ...]
    ON <replaceable class="PARAMETER">object</replaceable> [ ( <replaceable class="PARAMETER">column</replaceable> [, ...] ) ] [, ...]
    TO { PUBLIC | <replaceable class="PARAMETER">username</replaceable> [, ...] } [ WITH GRANT OPTION ]
</synopsis>

   <para>
    <!-- 
    Fields are compatible with those in the <acronym>Postgres</acronym>
    implementation, with the following additions: -->

    設定項目は<acronym>Postgres</acronym>に実装されている物と互換性があり、さらに以下のようなものも付加されています。
</para>

    <variablelist>
     <varlistentry>
      <term><replaceable class="PARAMETER">privilege</replaceable></term>
      <listitem>
       <para>
	<!-- <acronym>SQL92</acronym> permits additional privileges 
        to be specified: -->
        <acronym>SQL92</acronym>は、以下のような追加の権限の指定も認めています。
</para>

	<variablelist>
	 <varlistentry>
	  <term>SELECT</term>
	  <listitem>
	   <para>
	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>REFERENCES</term>
	  <listitem>
	   <para>
            <!-- 
	    Allowed to reference some or all of the columns of a specific
	    table/view in integrity constraints. -->

            一貫性制約の中で、指定したテーブル/ビューのいくつかあるいはすべての列を参照することを許します。

	   </para>
	  </listitem>
	 </varlistentry>	

	 <varlistentry>
	  <term>USAGE</term>
	  <listitem>
	   <para>
            <!--
	    Allowed to use a domain, character set, collation
	    or translation.
	    If an object specifies anything other than a table/view,
	    <replaceable class="PARAMETER">privilege</replaceable>
	    must specify only USAGE. -->

            ドメイン、文字セット、照合、翻訳などを使うことを許可します。対象がテーブルまたはビュー以外のものを指定する場合には、<replaceable class="PARAMETER">privilege</replaceable>にはUSAGEだけを指定しなくてはなりません。

	   </para>
	  </listitem>
	 </varlistentry>	
	</variablelist>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><replaceable class="PARAMETER">object</replaceable></term>
      <listitem>

	<variablelist>
	 <varlistentry>
	  <term>[ TABLE ] <replaceable class="PARAMETER">table</replaceable></term>
	  <listitem>
	   <para>
	    <!-- <acronym>SQL92</acronym> allows the additional
	    non-functional keyword <literal>TABLE</literal>. -->

            <acronym>SQL92</acronym>では、<literal>TABLE</literal>という追加の、関数ではないキーワードを許可します。

	   </para>
	  </listitem>
	 </varlistentry>

	 <varlistentry>
	  <term>CHARACTER SET</term>
	  <listitem>
	   <para>
	    <!-- Allowed to use the specified character set. -->
            指定した文字セットを使うことを許可します。 

	   </para>
	  </listitem>
	 </varlistentry>	

	 <varlistentry>
	  <term>COLLATION</term>
	  <listitem>
	   <para>
	    <!-- Allowed to use the specified collation sequence. -->
            指定した照合順を使うことを許可します。 

	   </para>
	  </listitem>
	 </varlistentry>	

	 <varlistentry>
	  <term>TRANSLATION</term>
	  <listitem>
	   <para>
	    <!-- Allowed to use the specified character set translation.
            -->
            指定した文字セット翻訳の使用を許可します。 

	   </para>
	  </listitem>
	 </varlistentry>	

	 <varlistentry>
	  <term>DOMAIN</term>
	  <listitem>
	   <para>
	    <!-- Allowed to use the specified domain. -->
            指定したドメインを使うことを許可します。 

	   </para>
	  </listitem>
	 </varlistentry>	

	 <varlistentry>
	  <term>WITH GRANT OPTION</term>
	  <listitem>
	   <para>
	    <!-- Allowed to grant the same privilege to others. -->
             権限を与えられたユーザーが、さらに他のユーザーにも同じ権限を与えることを許可します。 

	   </para>
	  </listitem>
	 </varlistentry>	
	</variablelist>
      </listitem>
     </varlistentry>
    </variablelist>
  </refsect2>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->



