Try/Catch e Stored Procedures no SQL Server

Guia do artigo:

TRY/CATCH
EXECUTE
Stored Procedure
Par�metros
RETURN
DROP

TRY/CATCH

Os comandos TRY/CATCH s�o utilizados para controlar erros em grupos de comandos do SQL Server. Confira abaixo a sintaxe do uso do TRY/CATCH.


BEGIN TRY

{ comando_sql | bloco_comando }

END TRY

BEGIN CATCH

{ comando_sql | bloco_comando }

END CATCH

[ ; ]

Acima temos o comando_sql, que representa qualquer comando Transact-SQL, assim como o bloco_comando refere-se a qualquer bloco de comando que esteja em um bloco BEGIN/END ou em um batch.

Seguindo o uso nas linguagens de programaç�o orientadas a objeto, o bloco TRY � utilizado para inserirmos os comandos e, se houver algum erro, outro grupo de comandos, existente no bloco CATCH ir� assumir o controle.

Caso os comandos dentro do bloco TRY n�o apresentarem erros, o controle ser� passado ao comando localizado logo ap�s o comando END CATCH, ap�s a execuç�o do �ltimo comando do bloco TRY.

O uso dos blocos TRY/CATCH cont�m algumas consideraç�es importantes, abaixo apresento algumas delas:

Qualquer erro de execuç�o com o valor de severidade superior a 10 e que n�o finaliza a conex�o com o banco de dados � capturado por TRY/CATCH.
Qualquer comando que for inserido entre os comandos END TRY e BEGIN CATCH ocasionar� um erro de sintaxe. Por isso � imprescind�vel que o bloco TRY seja imediatamente seguido por um bloco CATCH associado;
Por meio de alguns comandos, como RAISERROR, PRINT e at� conjuntos de SELECT, podemos retornar o erro de dentro do bloco CATCH para nossa aplicaç�o;
Blocos TRY e CATCH podem conter comandos TRY e CATCH aninhados;
O SQL Server possui comandos chamados GOTO, que podem ser usados para ir para um local espec�fico, localizada no mesmo TRY ou CATCH. Os comandos GOTO tamb�m servem para sair de um bloco TRY ou CATCH.

Com o objetivo de obter informaç�es a respeito do erro que provocar a execuç�o do bloco CATCH, temos v�rias funç�es do sistema que devem ser usadas no bloco CATCH. A tabela abaixo descreve as funç�es do sistema para esse fim:

Funç�o do Sistema	Descriç�o
ERROR_NUMBER()	Retorna o n�mero do erro.
ERROR_SEVERITY()	Retorna a severidade do erro.
ERROR_STATE()	Retorna o n�mero do estado de erro.
ERROR_PROCEDURE()	Retorna o nome da Trigger ou da Stored Procedure onde aconteceu o erro.
ERROR_LINE()	Retorna o n�mero da linha dentro da rotina que causou o erro.
ERROR_MESSAGE()	Retorna o texto completo da mensagem de erro, incluindo os par�metros como nomes de objetos.

Na Listagem 01 temos um exemplo de uso dos blocos TRY/CATCH.

Listagem 01. Exemplo com o uso dos blocos TRY/CATCH.


BEGIN TRY
  PRINT 'Execuç�o Iniciada'
  SELECT * FROM Products
END TRY
BEGIN CATCH
  SELECT
    ERROR_MESSAGE() AS MensagemdeErro,
    ERROR_NUMBER() AS N�meroErrado
END CATCH

EXECUTE

O comando EXECUTE (ou EXEC) quase sempre � usado para rodar Stored Procedures. Abaixo vemos a sintaxes do uso do EXECUTE.


EXECUTE [@Retorno =] { Nome_da_Procedure }

Nessa sintaxe, a mais usada, temos @Retorno e Nome_da_Procedure. @Retorno representa uma vari�vel que armazena o estado de uma Stored Procedure e deve ser declarada antes de ser usada com o EXECUTE. @Retorno � uma vari�vel opcional. Como � de se esperar Nome_da_Procedure representa o nome da Stored Procedure a ser executada.

Stored Procedure

Segundo a definiç�o mais conhecida, uma Stored Procedure � uma coleç�o de comandos SQL criada para utilizaç�o, permanente ou tempor�ria, em uma sess�o de usu�rio ou por todos os usu�rios.

Podemos executar as Stored Procedures no momento em que o SQL Server � iniciado, em per�odos espec�ficos do dia ou at� mesmo em um hor�rio espec�fico.

As Stored Procedures podem ser de tipos diferentes. Elas podem ser System Stored Procedures, Stored Procedures Locais, Remotas, Tempor�rias Locais e Globais e Extended Stored Procedure.

Vamos se focar nas Stored Procedures Locais, que s�o as criadas em bancos de dados individuais de usu�rios.

Abaixo, na Listagem 02, � visto um exemplo pr�tico da criaç�o de uma proc (nome abreviado para Stored Procedure) de SELECT, sem par�metros.

Listagem 02. Exemplo com Stored Procedure sem par�metros


CREATE PROCEDURE SP_SELECT_USUARIO
AS
  BEGIN
    SELECT IdUsuario, Usuario, Idade
      FROM Usuario
  END

Lembrando que o comando CREATE s� � utilizado na primeira vez em que a Procedure � criada. Nas demais vezes � usado o comando ALTER;.

Para executarmos essa Procedure � s� usarmos o comando EXECUTE ou EXEC, como a Listagem 03 nos mostra abaixo.

Listagem 03. Execuç�o da Stored Procedure sem par�metros.


  EXEC SP_SELECT_USUARIO

Par�metros

As Procedures aceitam tanto par�metros de entrada como retornam par�metros de sa�da. As Procedures n�o retornam valores no lugar de seus nomes. Al�m disso, n�o podem ser usadas no lugar de express�es. Isso � o que difere a Procedure de Functions (Funç�es).

A Listagem 04 nos mostra um exemplo de uma Procedure de INSERT com par�metros de entrada e um par�metro de sa�da, que retornar� o ID gerado ap�s o INSERT, para o respectivo par�metro.

Listagem 04. Execuç�o da Stored Procedure com par�metros de entrada e sa�da.


CREATE PROCEDURE SP_INSERT_USUARIO
        @IdUsuario      AS INT OUTPUT
      , @Usuario        AS VARCHAR(50)
      , @Idade          AS SMALLINT
      , @DataCadastro   AS DATETIME
AS
  BEGIN
    INSERT INTO
        Usuario
    VALUES
        (@Usuario,@Idade,@DataCadastro)
    SELECT
        @IdUsuario = SCOPE_IDENTITY()
  END

Notem que o par�metro @IdUsuario cont�m ao final de sua declaraç�o a palavra OUTPUT. Esse tipo de par�metro tamb�m pode ser chamado de par�metro por refer�ncia. Assim, ao final do INSERT, � gerado o ID do registro inserido e, por meio do SCOPE_IDENTITY(), � retornado este ID para o meu par�metro.

Quando usamos o OUTPUT, podemos manter qualquer valor atribu�do ao par�metro enquanto a procedure � executada, mesmo depois que ela tenha sido finalizada.

RETURN

Atrav�s do comando RETURN, � poss�vel fazer com que a procedure retorne um valor, que deve ser um n�mero inteiro. A Listagem 05 ilustra um exemplo com o uso do RETURN.

Listagem 05. Exemplo de Procedure com o uso do RETURN.


ALTER PROCEDURE SP_INSERT_USUARIO
        @IdUsuario      AS INT OUTPUT
      , @Usuario        AS VARCHAR(50)
      , @Idade          AS SMALLINT
      , @DataCadastro   AS DATETIME
AS
  BEGIN
    INSERT INTO
        Usuario
    VALUES
        (@Usuario,@Idade,@DataCadastro)
    IF @@ERROR <> 0
      BEGIN
        RAISERROR(50002,16,1)
          RETURN -1
      END
    ELSE
      SELECT
          @IdUsuario = SCOPE_IDENTITY()
  END

Assim, se houver erros no momento que o INSERT � executado no banco, a procedure nos retornar� -1, assim podemos saber se o registro foi gravado no banco ou n�o.

DROP

Para excluir uma Procedure utilizamos o comando DROP, como pode ser visto abaixo, na Listagem 06.

Listagem 06. Exclus�o de uma Stored Procedure.


DROP PROCEDURE SP_INSERT_USUARIO

Deixo como dica para que voc�s procurem mais informaç�es a respeito das Stored Procedures, que s�o uma �m�o na roda� para desenvolver aplicaç�es customizadas, com segurança e sem deixar aquele monte de instruç�es SQL direto na aplicaç�o, gerando assim menos erros para voc� e mais confiabilidade para o seu cliente!