ANEXO TÉCNICO PROCEDIMENTOS PARA EXECUÇÃO DE SCRIPTS EM BANCO DE DADOS DO GEMCO ANYWHERE

Transcrição

1 ANEXO TÉCNICO PROCEDIMENTOS PARA EXECUÇÃO DE SCRIPTS EM BANCO DE DADOS DO GEMCO ANYWHERE. Introdução Este manual aborda os procedimentos para atualização de bancos de dados do sistema Gemco. A atualização dos scripts é um procedimento importante que faz parte das rotinas de manutenção do sistema. Com a atualização dos scripts são criadas tabelas, campos e feitos ajustes essenciais à estrutura do banco de dados. Ao receber uma nova versão do aplicativo Gemco ou modulares, o banco de dados deve estar atualizado, ou seja, com os scripts executados, para que esta versão funcione adequadamente. Abordaremos os procedimentos de como obter os scripts, de sua organização, nomenclatura, execução e erros comuns que pode-se enfrentar. 2. Escopo As instruções deste manual atendem todos os produtos Bematech Gemco na base de dados SQL Server ou Oracle. 3. Obtenha os scripts Existem dois meios para a obtenção dos scripts: Via CD enviado pela Bematech (pasta scripts ) Via FTP BBS Bematech ( Via BBS, siga os seguintes passos:. Acesse e clique em Área restrita. 2. Selecione BBS Gemco e entre com o usuário e a senha fornecidos pela Bematech, selecione os arquivos em Recebimento e copie para um diretório de controle dos Scripts em sua máquina. Observação: Se não possuir nenhum usuário e senha, solicite ao Suporte Bematech. A BBS armazena os arquivos por tempo limitado, onde a cada 3 meses é realizada uma limpeza automática dos arquivos disponibilizados. Por isso salientamos a importância de sempre copiar os arquivos para a Estação ou Servidor assim que disponíveis.

2 4. Organize os scripts Organize seus scripts. A organização é fundamental para que não haja faltas na ordem de execução e para que tenhamos o histórico do que já foi executado. Sugerimos a criação de um pasta scripts no diretório C:\Suporte\ do próprio servidor ou estação administrativa no Data Center. Abaixo desse diretório crie duas pastas: Executados e Novos. Assim, teríamos a seguinte estrutura: C:\Suporte\Scripts\Executados C:\Suporte\Scripts\Novos No banco de dados à tabela GEMCO_SCRIPTS_EXECUTADOS registra os scripts executados. Para listar os scripts executados, execute o seguinte comando no SQL Query Analizer (SQL Server) ou SQL Plus (Oracle): select * from gemco_scripts_executados order by script 5. Nomenclaturas padrão dos bancos de dados Como referência, ao implantar o sistema Gemco, adotamos a seguinte nomenclatura para os bancos de dados: SQL Server Oracle Produção dbgemco GEMCO Treinamento e testes dbtreinamento TREINO Demonstração dbdemo DEMO CEP dbcep CEP 6. Tipos e ordem de execução dos scripts Os arquivos para atualização ou manutenção do banco de dados possuem a extensão.sql e são denominados scripts. Os scripts podem ser de dois tipos: banco de dados ou segurança. Nomenclatura para SQL Server: Scripts de banco de dados: IPLAA0000.SQL Scripts de segurança: SQDDMMAA.SQL Scripts de banco de dados - Modular: MODAA0000.SQL Nomenclatura para Oracle: Scripts de banco de dados: IPLAA0000.ORA Scripts de segurança: ORDDMMAA.SQL Scripts de banco de dados - Modular: MODAA0000.ORA

3 Onde AA é o ano em que o script foi desenvolvido (exemplo: 3 refere-se a scripts do ano de 203). Onde MOD é o modular em que o script foi desenvolvido (exemplo: FIN refere-se a scripts do modular Financeiro). Ordem de execução A ordem de execução dos scripts para atualizar o banco de dados deve respeitar a sequência de AA (Ano) e depois a sequência Numérica. Já a execução dos scripts de segurança deve respeitar a sequência da Data. Exemplo (no caso, para scripts SQL Server): Suponha que tenham sido recebidos os seguintes scripts: Script Data Hora Tamanho IPL3000.SQL 28/2/203 4:30 60 SQ2093.SQL 2/09/203 9:59 22 IPL40002.SQL 25/0/204 5:34 8 SQ0304.SQL 03/0/204 7: FIN400.SQL 02/02/204 3:02 20 Primeiro, deverão ser executados os scripts para atualização do banco de dados: Script Data IPL3000.SQL 28/2/203 IPL40002.SQL 25/0/204 FIN400.SQL 02/02/204 Depois, deverão ser executados os scripts para atualização da segurança do Gemco. Script Data SQ2093.SQL 2/09/203 SQ0304.SQL 03/0/ Procedimento para executar os scripts em SQL Server Os scripts deverão ser executados conforme a ordem apresentadas no tópico 7, através do utilitário MS Query Analyzer ou SQL Server Management Studio.. SQL Server Informe o nome do Servidor de Banco de Dados 2. Login Name gemco 3. Password gemco (ou a senha definida) 4. Ok

4 5. Após a conexão, certifique-se de que o banco apropriado esteja selecionado na barra de ferramentas. Na pasta identificada por QUERY, na metade superior da tela:. Escolha no Menu principal a opção FILE, OPEN 2. Na caixa OPEN FILE, selecione o arquivo.sql 3. OPEN < ENTER > 4. Execute o script clicando na a opção QUERY, EXECUTE ou pressione as teclas CTRL+E. Repita os passos à 4 para todos os scripts novos que ainda não foram executados. Lembre-se sempre de seguir a sequência conforme explicado no tópico Procedimento para executar os scripts em Oracle Os scripts deverão ser executados conforme a ordem apresentadas no tópico 7, através do utilitário SQL Plus. Conecte-se com o servidor, preenchendo as seguintes informações:. Username GEMCO (no Oracle, o usuário determina qual é a base de dados que sera atualizada) 2. Password GEMCO (ou a senha definida) 3. Host String String de conexão com o servidor de banco de dados 4. Ok < ENTER > 5. No prompt identificado por SQL> Exemplo: <ENTER> Repita o passo 5 para todos os novos scripts restantes.

5 Apêndice A Principais mensagens de erro ao executar scripts em SQL Server Mensagens na execução normal do script: The command(s) completed successfully. Indica que o comando executado não retorna dados. Ocorre quando o comando executado for: CREATE TABLE, ALTER TABLE (coluna e remoção de constraint), DROP TABLE, CREATE INDEX, DROP INDEX. ( X row(s) affected) Indica que o comando alterou X linhas da tabela em questão. Ocorre quando o comando executado for: INSERT INTO, UPDATE, DELETE, ALTER TABLE (adição: Primary Key, Foreign Key). Caution: Changing any part of an object Indica que o objeto XX (objeto ou coluna) foi name could break scripts and stored renomeado para YY. Informa também que procedures. poderão ocorrer problemas com stored The XX was renamed to YY. procedures ou scripts. Default bound to column. Indica que foi associado um default a determinada coluna de determinada tabela. Default unbound from table column. Indica que foi removida a associação de um default de determinada coluna de determinada tabela. Para script executado mais de uma vez: Server: Msg 274, Level 6, State 6, Line Indica que o objeto XX (tabela, primary key, foreign key ou index) já existe no banco de dados. Server]There is already an object named XX in the database. Server: Msg 2705, Level 6, State 4, Line Indica que a coluna XX já existe na tabela YY. Server]Column names in each table must be unique. Column name XX in table YY is specified more than once. Server: Msg 5335, Level, State, Indica a tentativa de renomear um objeto Procedure sp_rename, Line 332 (Tabela, Primary Key, Foreign Key ou Index) com um nome que já existe no banco de dados. Server]Error: value XX

6 is already in use as a object name and would cause a duplicate that is not permitted. Server: Msg 5225, Level, State, Procedure sp_rename, Line 27 Server]No item by the name of XX could be found in the current database DB, given was input as '(null)'. Indica a tentativa de renomear uma coluna com um nome que já existe no banco de dados. de advertência que poderá retornar: Server: Msg 779, Level 6, State, Line [Microsoft][ODBC SQL Server Driver][SQL Server]Table 'XX' already has a primary key defined on it. Server: Msg 750, Level 6, State, Line Server]Could not create constraint. See previous errors. Server: Msg 370, Level, State 5, Line Server]Cannot drop the table XX, because it does not exist in the system catalog. Server: Msg 93, Level 6, State, Line Server]There is already an index on table XX named YY. Server: Msg 3703, Level, State 7, Line [Microsoft] [ODBC SQL Server Driver][SQL Server]Cannot drop the index XX, because it does not exist in the system catalog. Server: Msg 370, Level, State 5, Line [Microsoft] [ODBC SQL Server Driver][SQL Server]Cannot drop the trigger XX, because it does not exist in the system catalog. Indica tentativa de criar uma primary key na tabela XX, sendo que esta já existe. Indica que a tabela XX não pode ser apagada porque não existe no banco de dados. Indica que o índice YY não pode ser apagado porque já existe no banco de dados. Indica que o índice XX não pode ser apagado porque não existe no banco de dados. Indica que o trigger XX não pode ser apagado porque não existe no banco de dados.

7 Server: Msg 2627, Level 4, State, Line [Microsoft][ODBC SQL Server Driver][SQL Server]Violation of PRIMARY KEY constraint XX. Cannot insert duplicate key in object YY. The statement has been terminated. Server: Msg 547, Level 6, State, Line [Microsoft][ODBC SQL Server Driver][SQL Server]INSERT statement conflicted with COLUMN FOREIGN KEY constraint XX. The conflict occurred in database DB, table YY, column WW. The statement has been terminated. Server: Msg 3728, Level 6, State, Line Server] XX is not a constraint. Server: Msg 3727, Level 6, State, Line Server]Could not drop constraint. See previous errors. Server: Msg 776, Level 6, State, Line [Microsoft] [ODBC SQL Server Driver][SQL Server]There are no primary or candidate keys in the referenced table XX that match the referencing column list in the foreign key YY. Server: Msg 750, Level 6, State, Line Server]Could not create constraint. See previous errors. Indica que violou a primary key XX da tabela YY. Ocorreu uma tentativa de inserir uma linha na tabela com os campos que formam a primary key XX já existente na tabela YY. Indica que violou a foreign key XX da tabela. Ocorreu uma tentativa de inserir uma linha na tabela com um campo WW que deveria existir na tabela YY e não existe. Indica que o objeto XX não foi encontrado no banco de dados e portanto não foi possível executar o comando para eliminar a constraint (Primary Key ou Foreign Key). Ou não existe a constraint ou então possui outro nome. Indica tentativa de criar uma foreign key YY sem existir a primary key na tabela referenciada XX. Mensagens que necessitam da interferência do usuário: Can't allocate space for object X in Indica que o não há mais espaço no log de database DB because the Y segment is transações, e este precisa ser limpo. full. If you ran out of space in Syslogs, Normalmente este erro ocorre quando é um dump the transaction log. Otherwise, use comando muito extenso for executado no banco ALTER DATABASE or sp_extendsegment de dados. Caso a limpeza do log não solucione to increase the size of the segment. o problema, deve-se verificar o tamanho do

8 TEMPDB. Caso o erro persista, deve-se verificar o tamanho do BANCO DE DADOS.

9 Apêndice B Principais mensagens de erro ao executar scripts em Oracle Mensagens na execução normal do script: Table created. Table altered. Index created. Sequence created. X row(s) created. X rows selected. X row(s) updated. X row(s) deleted. Table truncated. Table renamed. Trigger created. Procedure created. PL/SQL procedure successfully completed. Table dropped. Index dropped. Sequence dropped. Trigger dropped. Procedure dropped. Indica que a tabela foi criada com sucesso. Ocorre quando o comando executado for CREATE TABLE. Indica que o comado ALTER TABLE foi realizado com sucesso (Adicionar Coluna, associar Default, criar Primary Key, criar Foreign Keyremover Primary Key, remover Foreign Key ou modificar o tamanho / tipo da coluna). Indica que o índice foi criado com sucesso, através do comando CREATE INDEX. Indica que a sequência foi criada com sucesso. Indica que o comando inseriu X linhas da tabela em questão. Ocorre quando o comando executado for INSERT INTO. Indica número de linhas selecionados pelo comando SELECT (este retorno só aparecerá se o número de linhas retornadas for maior ou igual a 6). Indica que o comando alterou X linhas da tabela em questão. Ocorre quando o comando executado for UPDATE. Indica que X linhas foram removidas da tabela em questão. Ocorre quando o comando executado for DELETE. Indica que a tabela foi truncada, ou seja, todas as linhas da tabela foram removidas. Indica que a tabela foi renomeada. Este é o único objeto que pode ser renomeado no Oracle. Indica que o trigger foi criada com sucesso. Indica que a stored procedure foi criada com sucesso. Indica que o procedimento (Stored Procedure ou um PL/SQL) foi executado com sucesso. Indica que a tabela foi eliminada com sucesso. Indica que o índice foi eliminado com sucesso. Indica que a sequência foi eliminada com sucesso. Indica que o trigger foi eliminada com sucesso. Indica que a stored procedure foi eliminada com sucesso. Para script executado mais de uma vez:

10 Indica que o objeto (tabela, primary key, foreign ORA-00955: name is already used by an key, índice, stored procedure, sequence) já existing object. existe no usuário de banco de dados. Indica que a coluna já existe no usuário de ORA-0430: column being added already banco de dados. exists in table Indica que a tabela já possui primary key. ORA-02260: table can have only one primary key ERROR at line 2: Indica que a tabela já possui foreign key. ORA-02275: such a referential constraint already exists in the table Indica que o trigger XX_TR já existe no usuário ORA-0408: trigger 'XX_TR' already exists de banco de dados. ERROR at line 2: Indica tentativa de criar índice único, sendo que ORA-0452: cannot CREATE UNIQUE este já existe. INDEX; duplicate keys found Mensagens de advertência: ORA-02260: table can have only one primary key ORA-00942: table or view does not exist de dados. ORA-048: specified index does not exist ORA-04080: trigger 'XX_TR' does not exist ORA-0000: unique constraint (GEMCO.XX) violated ORA-0229: integrity constraint (GEMCO.X_FK_Y) violated - parent key not found Indica tentativa de criar uma Primary Key na tabela XX, sendo que esta já existe. Indica que a tabela em questão não pode ser apagada porque não existe no usuário de banco Indica que o índice em questão não pode ser apagado porque não existe no usuário de banco de dados. Indica que o trigger XX_TR não pode ser apagado porque não existe no usuário de banco de dados. Indica que violou a Primary Key ou o índice único XX. Ocorreu uma tentativa de inserir uma linha na tabela com os valores das colunas que formam a Primary Key ou o índice único já existentes na tabela. Indica que violou a foreign key X_FK_Y da tabela. Ocorreu uma tentativa de inserir uma linha na tabela com um campo WW que deveria existir na tabela Y e não existe.

11 ORA-02443: Cannot drop constraint - nonexistent constraint ORA-0244: Cannot drop nonexistent primary key ERROR at line 3: ORA-02270: no matching unique or primary key for this column-list ORA-02266: unique/primary keys in table referenced by enabled foreign keys ORA-00902: invalid datatype ORA-00947: not enough values ORA-02298: cannot enable (GEMCO.XX_FK_Y) - parent keys not found Indica que o objeto não foi encontrado no usuário de banco de dados e portanto não foi possível executar o comando para eliminar a constraint (Primary Key ou Foreign Key). Ou não existe a constraint ou então possui outro nome. Indica que não foi possível eliminar a Primary Key porque esta não existe. Indica tentativa de criar uma Foreign Key sem existir a Primary Key na tabela referenciada. Indica tentativa de eliminar uma tabela que é referenciada por outra com uma Foreign Key. Indica tentativa de criar relacionamento para Foreign Key com colunas de tipos diferentes. Indica tentativa de inserir dados na tabela com número de argumentos do Insert diferente do número do Values. Indica tentativa de criar um relacionamento entre a tabela XX e Y, sendo que o dado da Foreign Key da tabela filho XX não existe na tabela pai Y. Mensagens que necessitam da interferência do usuário: Warning: Trigger created with compilation errors. Warning: Procedure created with compilation errors. ORA-00933: SQL command not properly ended Indica que o trigger foi gerada com erro de compilação. Será necessário corrigi-lo. Para a visualização do erro digitar no prompt do SQL Plus: SQL> show error trigger NOME_DO_TRIGGER <enter> Indica que a stored procedure foi gerada com erro de compilação. Será necessário corrigi-lo. Para a visualização do erro digitar no prompt do SQL Plus: SQL> show error procedure NOME_DA_SP <enter> Indica que o comando não foi terminado apropriadamente. Será necessário corrigi-lo.

12 ORA-0658: unable to create INITIAL extent for segment in tablespace GEMCO_DAT ORA-0555: snapshot too old (rollback segment too small) ORA-0562: failed to extend rollback segment ID = num Indica que não foi possível executar o comando (CREATE TABLE, INSERT INTO) porque não existe mais espaço em disco disponível. Indica que o segmento de rollback habilitado é muito pequeno. Indica que não foi possível aumentar o segmento de rollback identificado por NUM.