{"id":749,"date":"2017-07-09T16:32:00","date_gmt":"2017-07-09T19:32:00","guid":{"rendered":"http:\/\/www.profissionaloracle.com.br\/swillians\/2017\/07\/09\/capturando-erros-em-dml-s\/"},"modified":"2024-01-27T11:43:42","modified_gmt":"2024-01-27T14:43:42","slug":"capturando-erros-em-dml-s","status":"publish","type":"post","link":"https:\/\/www.profissionaloracle.com.br\/2017\/07\/09\/capturando-erros-em-dml-s\/","title":{"rendered":"Capturando Erros em DML&#8217;s"},"content":{"rendered":"\n<p><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Capturando Erros em DML&#8217;s<\/h3>\n\n\n\n<p>\u00c9 de extrema necessidade se precaver dos erros que podem ocorrer em cargas de dados, transformando-os e\/ou sanitizando-os para uma melhor qualidade dos registros. Mas ora ou outra surgem linhas que trazem alguma informa\u00e7\u00e3o incompat\u00edvel com o tipo de dados de alguma coluna da tabela. \u00c9 a\u00ed que est\u00e1 o problema.<\/p>\n\n\n\n<p>Na verdade \u00e9 pr\u00e1tica comum de mercado criar tabelas acess\u00f3rias para aglutinar estes poss\u00edveis erros para uma posterior auditoria e tratativa. Mas grande parte das vezes vejo que o processo \u00e9 feito de forma manual, atrav\u00e9s de Exception\u2019s no c\u00f3digo PL\/SQL. N\u00e3o \u00e9 errado, contudo deixamos de utilizar uma \u00f3tima feature do Oracle, o qual automatiza o processo dentro do pr\u00f3prio comando DML.<\/p>\n\n\n\n<p>As cl\u00e1usulas LOG ERRORS, REJECT e LIMIT auxilia no preenchimento dos erros ocasionalmente ocorridos na tabela acess\u00f3ria criada pela procedure DBMS_ERRLOG.CREATE_ERROR_LOG. Ao utilizar estas op\u00e7\u00f5es o Oracle ir\u00e1 fazer todo o trabalho sujo.<\/p>\n\n\n\n<p>Vamos para a parte pr\u00e1tica para entender como este processo funciona:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Inicialmente criaremos a tabela TEMP_TESTE_1 para receber uma posterior carga de dados:<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">CREATE TABLE temp_teste_1\n &nbsp;(\n &nbsp;&nbsp;&nbsp;ID &nbsp;&nbsp;&nbsp;&nbsp;NUMBER,\n &nbsp;&nbsp;&nbsp;NOME VARCHAR2(10),\n &nbsp;&nbsp;&nbsp;CLASSE NUMBER\n &nbsp;);<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Com a utiliza\u00e7\u00e3o da procedure DBMS_ERRLOG.CREATE_ERROR_LOG cria-se a tabela, a qual ser\u00e1 gravados os log\u2019s.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">EXEC DBMS_ERRLOG.CREATE_ERROR_LOG('temp_teste_1', 'temp_teste_1_log');<\/code><\/pre>\n\n\n\n<p>Em suma, a procedure DBMS_ERRLOG.CREATE_ERROR_LOG faz uma c\u00f3pia da tabela principal, adicionando as colunas ORA_ERR_NUMBER$, ORA_ERR_MESG$, ORA_ERR_ROWID$, ORA_ERR_OPTYP$ e ORA_ERR_TAG$. Outro ponto interessante \u00e9 que todas as demais colunas pertencente a tabela principal n\u00e3o s\u00e3o criadas considerando o mesmo tipo de dados, mas sim como VARCHAR2(4000), tendo como objetivo desfazer quaisquer eventuais incompatibilidade de dados.<\/p>\n\n\n\n<p>Outro adendo \u00e9 que a procedure DBMS_ERRLOG.CREATE_ERROR_LOG apenas automatiza o processo da cria\u00e7\u00e3o da tabela. Contudo, pode-se cri\u00e1-la manualmente atrav\u00e9s do CREATE TABLE, respeitando apenas a obrigatoriedade da exist\u00eancia dos campos de final $.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh3.googleusercontent.com\/s2z3VjYMJA-FqmiObvp7AWRS4Tm4uERyL0j6Qk-f6dLMTdZqszbAsqyMr-rO95LEVSvYMZ5rpV8SODqKRV60KFPSrHbN0lqfU4q_3Ge-IgKoSTz_c7yeq56jQqWW-j6HD9bqmpqlMXDNJQsBSQ\" alt=\"Capturando Erros em DML\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<ul class=\"nv-cv-m wp-block-list\">\n<li>Agora se cria a tabela que conter\u00e1 os dados que ser\u00e3o utilizados para a carga com 1000 registros. Com intuito de promover erro intencional, 200 linhas possuem 11 caracteres no campo NOME, gerando incompatibilidade de tamanho de campo com a respectiva coluna da tabela TEMP_TESTE_1, a qual tem tamanho m\u00e1ximo de 10 caracteres.<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">CREATE TABLE temp_teste_carga AS\nSELECT ROUND(dbms_random.value(1,10)) ID,\n &nbsp;(\n &nbsp;&nbsp;&nbsp;CASE MOD(ROWNUM,5)\n &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WHEN 0\n &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;THEN CAST (dbms_random.STRING('U',11) AS VARCHAR2(11))\n &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ELSE CAST (dbms_random.STRING('U',10) AS VARCHAR2(10))\n &nbsp;&nbsp;&nbsp;END) NOME,\n &nbsp;MOD(ROWNUM,5) CLASSE\nFROM DUAL\n &nbsp;CONNECT BY LEVEL &lt;= 1000;\n\nSELECT count(*)\nFROM temp_teste_carga;<\/code><\/pre>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh3.googleusercontent.com\/5aV2gVywf_Q53xD0iWIDpMusMq8SOJ1-d6GT_u82bSTXk3C5h8yzoKnpihx8_GISkdsLXXjct5wh11zSqM-iBWoMpTpPylH9c3Gd7rhv6WXfz-rFxkNLXJ8lR4Cyt5GpkjFGLuP85APXLkvSgg\" alt=\"\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<p>Em decorr\u00eancia de existirem 200 linhas com tamanho incompat\u00edvel para o campo NOME, ser\u00e1 emitido o INSERT abaixo. Logo em seguida percebemos que o erro ORA-12899 \u00e9 emitido e \u00e9 feito ROLLBACK para a transa\u00e7\u00e3o como um todo, ou seja, nenhuma linha \u00e9 gravada na tabela TEMP_TESTE_1.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">INSERT INTO TEMP_TESTE_1\nSELECT *\nFROM TEMP_TESTE_CARGA;<\/code><\/pre>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh6.googleusercontent.com\/QemSXOMo04HZ_4cKyGMxTX5znP_O3o9SmK5mBV3mUo8DwchML-Vy6VsBMgP2DxdPWV4B6wTtojQlAV0DdaiQHfcCpLDRhC1D2lLb4ipryopWayppRLd2IsCnlyIIzY0foL8_HdBc2c4pUgmqhw\" alt=\"\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<p>Agora se utilizando das instru\u00e7\u00f5es LOG ERRORS, REJECT e LIMIT ser\u00e1 emitido um novo INSERT. Nota-se que foram inseridas 800 linhas das 1000 originais. Os demais 200 registros com tamanho incompat\u00edvel n\u00e3o provoca ROLLBACK da instru\u00e7\u00e3o como um todo, sendo apenas registrados na tabela TEMP_TESTE_1_LOG, conforme podemos ver nas evid\u00eancias abaixo:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">INSERT INTO TEMP_TESTE_1\nSELECT *\nFROM TEMP_TESTE_CARGA\nLOG ERRORS INTO temp_teste_1_log REJECT LIMIT UNLIMITED;<\/code><\/pre>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh5.googleusercontent.com\/zPvibFgmmcCSlxExRn-59iZEz6z2EhdkkrJ21ZUUZ7jl05aoJ8jKnJIoxulIe-7COZ3VvIyWiT6LmXj_iKOErNwec9vuh6ES9uzFG76YnJg4SCHPEOMlmzGbzAwsYkyBW2QORp5VzC2f_cOqSA\" alt=\"\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">SELECT COUNT(*) FROM temp_teste_1_log;<\/code><\/pre>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh6.googleusercontent.com\/X040qo4cf45QNwsFbXiIncQ0JxiFHizrMKVfKvTV0K9g5_7HNSZ2USL1a2REbYJy_kA7BYf9l_HesZW0t7Qde-VK7TZgbok9rD8HzREWvm1k3qKVeceSz4s-IWdv2a3Aa89vtyV4YXHq8y85Mg\" alt=\"\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<p>Os logs de erros s\u00e3o gravados para cada uma das linhas na tabela TEMP_TESTE_1_LOG, nos dando total rastreabilidade para auditoria e tratativas futuras.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"sql\" class=\"language-sql\">SELECT ORA_ERR_NUMBER$,\n &nbsp;ORA_ERR_MESG$,\n &nbsp;ORA_ERR_OPTYP$,\n &nbsp;ID,\n &nbsp;NOME,\n &nbsp;CLASSE\nFROM temp_teste_1_log;<\/code><\/pre>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh4.googleusercontent.com\/b3a2Vll7jGWlRaQPXZIc5CFQCdU8utV3usdmqBEgmBZntFrWYNbB8L5pZHgYKp6qM_TB1TP17UrSV4SCqAw3iOatmMWn61eadJpIrmMD4nnab07Oici5qN7z0Dbk3FlnyB-jr2MikMN9VdgvFA\" alt=\"\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<p>Analisando individualmente cada linhas v\u00ea-se que \u00e9 registrado:<\/p>\n\n\n\n<ul class=\"nv-cv-m wp-block-list\">\n<li>C\u00f3digo do erro;<\/li>\n\n\n\n<li>A mensagem descritiva do erro;<\/li>\n\n\n\n<li>O tipo do processo, sendo: Insert, Update, Delete;<\/li>\n\n\n\n<li>Os dados das linhas da tabela principal coluna a coluna;<\/li>\n<\/ul>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/lh4.googleusercontent.com\/99jlTUvzYrboxZuiAhhJTiNNeVjV9yrMu-chmkrQ9H4HuAHI6O9sFBxu6Ni27hMc70na_r4xOGk09kxGqQVbq7wNkr7Ikd0f8btmBYOwwOzQc4LUT-NVur9bqb4JgLHrPJ6EkaiIbnkyw9rdaw\" alt=\"\" title=\"\"><figcaption class=\"wp-element-caption\"> <\/figcaption><\/figure><\/div>\n\n\n<p>Outros pontos relevantes s\u00e3o:<\/p>\n\n\n\n<ul class=\"nv-cv-d nv-cv-m wp-block-list\">\n<li>A instru\u00e7\u00e3o UNLIMITED pode ser substitu\u00edda por um n\u00famero, onde o mesmo controlar\u00e1 a quantidade de erros que pode ser emitido antes de um eventual ROLLBACK de toda a instru\u00e7\u00e3o;<\/li>\n\n\n\n<li>Ainda que o INSERT seja atrav\u00e9s de Direct Path a grava\u00e7\u00e3o na tabela de log ser\u00e1 em Conventional Path. Contudo, isto n\u00e3o deve ser um problema para performance como um todo, haja vista que dever\u00e1 ser logado apenas erros ocasionais. Se existirem n\u00fameros parecidos de inserts com sucesso e com erro, pare tudo o que tiver fazendo e volte para o passo de transforma\u00e7\u00e3o das informa\u00e7\u00f5es.<\/li>\n\n\n\n<li>A tabela de log \u00e9 manipulada atrav\u00e9s de AUTONOMOUS_TRANSACTION, ou seja, poss\u00edveis ROLLBACK na instru\u00e7\u00e3o principal n\u00e3o ir\u00e1 influenciar\u00e1 e preservar\u00e1 os registros da tabela de log.<\/li>\n\n\n\n<li>LONGs, LOBs e tipo de dados Objeto n\u00e3o dever\u00e3o ser criados na tabela de log;<\/li>\n<\/ul>\n\n\n\n<p><strong>Refer\u00eancias<\/strong><\/p>\n\n\n\n<ul class=\"nv-cv-d nv-cv-m wp-block-list\">\n<li><a aria-label=\"undefined (opens in a new tab)\" href=\"https:\/\/www.jeffersonacosta.com\/single-post\/2017\/06\/27\/Capturando-Erros-em-DMLs\" target=\"_blank\" rel=\"noreferrer noopener\">Capturando-Erros-em-DMLs<\/a><\/li>\n\n\n\n<li><a aria-label=\"undefined (opens in a new tab)\" href=\"http:\/\/www.dba-oracle.com\/t_packages_dbms_errlog.htm\" target=\"_blank\" rel=\"noreferrer noopener\">DBMS_ERRLOG<\/a><\/li>\n\n\n\n<li><a aria-label=\"undefined (opens in a new tab)\" href=\"https:\/\/docs.oracle.com\/database\/121\/ARPLS\/d_errlog.htm#ARPLS680\" target=\"_blank\" rel=\"noreferrer noopener\">DBMS_ERRLOG<\/a><\/li>\n\n\n\n<li><a aria-label=\"undefined (opens in a new tab)\" rel=\"noreferrer noopener\" href=\"http:\/\/www.apress.com\/us\/book\/9781430262206\" target=\"_blank\">PRO Oracle SQL<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Descubra como capturar erros em cargas de dados usando a feature LOG ERRORS do Oracle. Automatize o processo e melhore a qualidade dos registros.<\/p>\n","protected":false},"author":35,"featured_media":171343,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","neve_meta_reading_time":"","_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[6,8,26],"tags":[1522,4249,1493,5527,4248,177],"class_list":["post-749","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-artigos","category-artigo-programacao","category-sql-e-pl-sql","tag-dbms","tag-dbms_errlog","tag-dml","tag-exceptions","tag-log-errors","tag-oracle"],"publishpress_future_action":{"enabled":false,"date":"2025-03-18 01:04:28","action":"change-status","newStatus":"draft","terms":[],"taxonomy":"category"},"publishpress_future_workflow_manual_trigger":{"enabledWorkflows":[]},"_links":{"self":[{"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/posts\/749","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/users\/35"}],"replies":[{"embeddable":true,"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/comments?post=749"}],"version-history":[{"count":0,"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/posts\/749\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/media\/171343"}],"wp:attachment":[{"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/media?parent=749"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/categories?post=749"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.profissionaloracle.com.br\/wp-json\/wp\/v2\/tags?post=749"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}