# Instrução CREATE SYNONYM

A instrução CREATE SYNONYM é utilizada para fornecer um nome alternativo para uma tabela ou visão presente no mesmo esquema ou em outro esquema. Também podem ser criados sinônimos para outros sinônimos, resultando em sinônimos aninhados. O sinônimo pode ser utilizado no lugar do nome qualificado original da tabela ou da visão, nas instruções SELECT, INSERT, UPDATE, DELETE e LOCK TABLE. Pode ser criado um sinônimo para uma tabela ou uma visão que não existe, mas a tabela ou visão de destino deverá existir antes do sinônimo poder ser utilizado.

Os sinônimos compartilham o mesmo espaço de nomes das tabelas e visões. Não pode ser criado um sinônimo com o mesmo nome de uma tabela que já existe no mesmo esquema. De maneira semelhante, não pode ser criada uma tabela ou visão com nome correspondente a um sinônimo já existente.

O sinônimo pode ser definido para uma tabela ou visão que não existe quando o sinônimo é criado. Se a tabela ou visão não existir, será recebida uma mensagem de advertência (SQLState 01522). O objeto referenciado deverá existir quando o sinônimo for utilizado em uma instrução da DML.

Pode ser criado sinônimo aninhado (um sinônimo para outro sinônimo), mas qualquer tentativa de criar um sinônimo que resulte em uma referência circular retorna uma mensagem de erro (SQLState 42916).

Não podem ser definidos sinônimos nos esquemas do sistema. Todos os esquemas começando por 'SYS' são considerados esquemas do sistema, e são reservados pelo Derby.

Não pode ser definido um sinônimo para uma tabela temporária. A tentativa de definir um sinônimo para uma tabela temporária retorna uma mensagem de erro (SQLState XCL51).

#### Sintaxe

    CREATE SYNONYM nome-do-sinônimo FOR { nome-da-visão | nome-da-tabela }

Na instrução, nome-do-sinônimo representa o nome do sinônimo sendo atribuído à tabela ou visão de destino, enquanto nome-da-visão e nome-da-tabela representam o nome original da tabela ou visão de destino.

#### Exemplo

CREATE SYNONYM SAMP.T1 FOR SAMP.TABELA_COM_NOME_COMPRIDO
Tópico pai: Instruções CREATE
Referências relacionadas
Instrução CREATE FUNCTION
Instrução CREATE INDEX
Instrução CREATE PROCEDURE
Instrução CREATE SCHEMA
Instrução CREATE TABLE
Instrução CREATE TRIGGER
Instrução CREATE VIEW