Engenho &amp; Engenhocas

Para ler

Como redefinir um novo valor para a coluna identity em T-SQL

Para ler

IDENT_CURRENT (Transact-SQL)

Antes de mais nada, não importa qual é o valor da coluna identity. Está sempre bem, desde que seja único. Afinal, as pessoas não precisam de ver o valor.

No entanto, se é realmente necessário redefinir os valores da identidade (por exemplo, para um teste ou para um projecto), isso pode fazer-se no SQL Server.

Suponha-se o seguinte cenário, uma série de registos apagados de uma tabela com uma coluna identity. Como definir manualmente um novo valor de identidade para a coluna de identidade?

A função IDENT_CURRENT(<table_or_view>)retorna o último valor identity gerado para a tabela. O valor da última identidade gerado pode ser para qualquer sessão e para qualquer âmbito.

DBCC CHECKIDENT
(    <table_name>          
[, { NORESEED | { RESEED [, <new_reseed_value> ] } } ])

pode usar-se para definir manualmente um novo valor identity actual para a coluna de identidade.

Como funciona:

CREATE TABLE Product (
ProductID INT IDENTITY,
ProductName VARCHAR(200),
Price INT);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto1', 100);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto2', 250);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto3', 300);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto4', 340);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto5', 500);

SELECT * FROM Product;

DELETE FROM Product WHERE ProductID >= 2;

INSERT INTO Product (ProductName, Price)
VALUES ('Produto1', 100);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto2', 250);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto3', 300);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto4', 340);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto5', 500);

O último valor identity retorna 10.SELECT IDENT_CURRENT ('dbo.Product') AS Current_Identity;

Agora, aplicando o CHECKIDENT com RESEED

DELETE FROM Product WHERE ProductID >= 2;
DECLARE @MaxProductID AS INT;
SELECT @MaxProductID = MAX(ProductID) FROM dbo.Product;

DBCC CHECKIDENT ('dbo.Product', RESEED, @MaxProductID);

O último valor identity retorna 1.

SELECT IDENT_CURRENT ('dbo.Product') AS Current_Identity;

INSERT INTO Product (ProductName, Price)
VALUES ('Produto2', 250);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto3', 300);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto4', 340);

INSERT INTO Product (ProductName, Price)
VALUES ('Produto5', 500);

SELECT * FROM Product;

A execução pode ser analisada aqui.

Para aplicar a verificação do último valor identity gerado para todas as tabelas de bases de dados, utilizar o script explanado aqui.

Documentação:

DBCC CHECKIDENT (Transact-SQL)

T-SQL para limpeza de caracteres não legíveis

Para ler

DECLARE @strClean as VARCHAR(1000) = 'atuastringaqui';

SELECT LTRIM(RTRIM(REPLACE(REPLACE(REPLACE(REPLACE(@strClean, CHAR(10), CHAR(32)), CHAR(13), CHAR(32)), CHAR(160), CHAR(32)), CHAR(10), CHAR(32))))

A dimensão da equipa de desenvolvimento

Para ler

Limpeza de ramificações antigas no Git

Para ler

Mudar para a ramificação 'master' (o branch receptor actual)

$git checkout master
Swtiched to branch 'master'

Listar as linhas de desenvolvimento integradas na master

$git branch --merged
Lista das ramificações mescladas na ramificação principal mestre

Apagar a ramificação local

$git branch -d <nome do branch>
Delete branch <nome do branch> (was a244f48ce)

Exportar a eliminação da ramificação para o repositório central

$git push --delete origin <nome do branch>
To [url repositório git]
-[deleted] <nome do branch>

Remover os objectos git inacessiveis, ou seja, com refs antigas. --dry-run indica o que está marcado para ser removido, mas sem o remover

$git remote prune origin --dry-run
Prunning origin
URL: <url repositório git>
*[would prune] <nome do branch>

Apagar efectivamente as referências para ramificações que não existem no repo remoto

$git remote prune origin
Prunning origin
URL: <url repositório git>
*[prune] <nome do branch>

O comando Prune é considerado um comando de recolha de lixo (garbage collection) e é um comando filho do comando git GC.

Relacionado Aprender Git em Windows

Quando o Adobe Reader DC embutido na aplicação não abre o PDF

Para ler

Quando o gestor de transacções não permite transacções remotas

Para ler

COM Exception: The transaction manager has disabled its support for remote/network transactions.

Como resolver

Este problema está relacionado com transacções distribuidas. Esta gestão cabe ao Distributed Transaction Coordinator da Microsoft (MSDTC).

O Microsoft Distributed Transaction Coordinator (MSDTC) está activo no SQL Server 2017.

Configuração do MSDTC nos sistemas operativos Windows no cliente e no servidor:

Abrir Component Services.

Ou, no Server Manager, seleccionar Tools e depois seleccionar Component Services.

Expandir Component Services, Computers, My Computer e Distributed Transaction Coordinator

Clicar com o botão direito do rato em Local DTC e seleccionar Properties.

Seleccionar o separador Security.

Então, seleccionar as seguintes opções:

Network DTC Access
Allow Remote Clients
Allow Inbound
Allow Outbound
No Authentication Required

Seleccionar OK para guardar as alterações.

Propriedades de segurança do DTC

Se for solicitada a reinicialização do serviço MSDTC, seleccionar Yes.

Reiniciar o serviço do DTC

O serviço é reiniciado e a MMC Component Services pode ser fechada.

Se for necessário adicionar à firewall:

Abrir a Firewall do Windows e seleccionar Advanced Settings à esquerda. Ou, no Server Manager, seleccionar Tools e seleccionar Windows Firewall (Advanced Security).

Clicar com o botão direito do rato em Inbound Rules e seleccionar New Rule.

No wizard:

Seleccionar Program e seleccionar Next.

Definir o caminho do programa para

%SystemRoot%\system32\msdtc.exe

e seleccionar Next.

Permitir a conexão e seleccionar Next.

Seleccionar Domain e seleccionar Next.

Digitar um nome, como Conexão MSDTC por exemplo, e seleccionar Finish.

Concluir o assistente e fechar a Firewall do Windows.

Cláusulas Over e Partition by em SQL Server

Para ler

A cláusula OVER define uma janela ou conjunto de registos especificado pelo utilizador nos resultados da consulta. Uma função de janela calcula um valor para cada registo na janela. A cláusula OVER pode ser usada com funções para calcular valores agregados.

A cláusula PARTITION BY é uma sub-cláusula da cláusula OVER. A cláusula PARTITION BY divide os resultados de uma consulta em partições. A função da janela é executada em cada partição separadamente.

A cláusula PARTITION BY divide os resultados em partições e altera como a função da janela é calculada. A cláusula PARTITION BY não reduz o número de linhas retornadas.

O exemplo seguinte serve apenas para ilustrar a aplicação combinada destas cláusulas.

Exemplo para uma factura

CREATE TABLE Factura
  (
     ID INT,Numero VARCHAR(9),Montantetotal DECIMAL
  );

CREATE TABLE Facturalinha
  (
     ID INT,FacturaID INT,Descricao NVARCHAR(50),Montante DECIMAL
  );

INSERT INTO Factura
VALUES      (1,'002-00509',300.00);

INSERT INTO Facturalinha
VALUES      (1,1,'produto 01',50.00);

INSERT INTO Facturalinha
VALUES      (2,1,'produto 02',30.00);

INSERT INTO Facturalinha
VALUES      (3,1,'produto 03',20.00);

INSERT INTO Facturalinha
VALUES      (4,1,'produto descrição a definir',200.00);

INSERT INTO Factura
VALUES      (2,'003-00595',400.00);

INSERT INTO Facturalinha
VALUES      (1,2,'produto 01',70.00);

INSERT INTO Facturalinha
VALUES      (2,2,'produto 02',30.00);

INSERT INTO Facturalinha
VALUES      (3,2,'produto 03',100.00);

INSERT INTO Facturalinha
VALUES      (4,2,'produto 04',50.00);

INSERT INTO Facturalinha
VALUES      (5,2,'produto 05',150.00);

SELECT f.Numero AS "Factura número"
, ROW_NUMBER() OVER(PARTITION BY fl.FacturaID ORDER BY fl.ID ASC) AS "Linha nº"  
, fl.Descricao AS "Descrição"
, fl.Montante
, SUM(fl.Montante) OVER(PARTITION BY fl.FacturaID ORDER BY fl.ID ASC ROWS UNBOUNDED PRECEDING) AS "Montante acumulado"
, IIF(fl.ID = MAX(fl.ID) OVER (PARTITION BY fl.FacturaID), SUM(fl.Montante) OVER(PARTITION BY fl.FacturaID), 0)  AS "Montante total factura"
, f.MontanteTotal AS "Factura montante total"
FROM   Factura f
       INNER JOIN Facturalinha fl
               ON f.Id = fl.Facturaid

O SELECT apresenta o seguinte resultado

Relacionado: SQL PARTITION BY Clause overview

Fonte: Microsoft Docs

The 2020 Backend Technologies Roadmap

Para ler

Business analyst mindset and business success

Para ler

Definição de Pronto no Scrum vs Critério de Aceitação

Para ler

As ferramentas de desenvolvimento de topo de 2019

Para ler

Diferença entre Scrum e Kanban

Para ler

Desafios de um Product Owner para assumir a propriedade total do produto

Para ler

As vantagens da adopção do Scrum

Para ler

NLog com destino Seq - um ficheiro de log centralizado

Para ler

O Seq foi criado para o log estruturado moderno com templates, os modelos de mensagens. Nada de perder tempo e esforço a extrair dados de logs de texto sem formatação com análise de log frágil; as propriedades associadas a cada evento de log são capturadas e enviadas para o Seq em formato JSON.

Por outro lado, o NLog torna mais fácil a produção e gestão de logs de alta qualidade para qualquer aplicação, independentemente do tamanho ou complexidade e suporta a criação de destinos customizados.

Para usar o Seq com NLog há que instalar primeiro o pacote Nuget NLog.Targets.Seq.

PM> Install-Package NLog.Targets.Seq

Depois disto, adicionar a referência para a assembly à configuração do NLog

<nlog xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.nlog-project.org/schemas/NLog.xsd">

  <extensions>
    <add assembly="NLog.Targets.Seq"/>
  </extensions>
</nlog>

,adicionar o novo target, o destino,

<target name="seq" xsi:type="BufferingWrapper" bufferSize="1000" flushTimeout="2000" slidingTimeout="false">         <target xsi:type="Seq" serverUrl="http://localhost:5341" apiKey="" />  </target>

e estabelecer as regras de aplicação do novo destino de escrita para log

<rules>
  <logger name="*" minlevel="Info" writeTo="seq" />

  [...]
</rules>

Ilustração do exemplo do artigo NLog: logging mais fácil aplicado ao ficheiro de log centralizado Seq.

Exemplo de configuração para um Seq mais rico, para auditoria

<target name="seq" xsi:type="BufferingWrapper" bufferSize="1000" flushTimeout="2000" slidingTimeout="false">
<target xsi:type="Seq" serverUrl="http://localhost:5341" apiKey="" >
<property name="ThreadId" value="${threadid}" as="number" />
<property name="MachineName" value="${machinename}" />
<property name="UserName" value="${windows-identity}" />
<property name="ID" value="${guid:GeneratedFromLogEvent=true}"/>
<property name="Source" value="${callsite}"/>
<property name="Time" value="${longdate}"/>
<property name="Agent" value="${environment-user}"/>
<property name="Level" value="${uppercase:${level}}"/>
<property name="Count" value="${sequenceid}"/>
</target>
</target>

fontes: https://blog.datalust.co/nlog-4-5-structured-logging/,
https://github.com/datalust/nlog-targets-seq

NLog: Configuração programática

Para ler

O artigo NLog: logging mais fácil faz uma apresentação desta plataforma e exemplifica a sua utilização. A configuração pode ser feita tanto por ficheiro .config como programaticamente.

Aqui exemplifica-se como usar código (C#) para fazer a configuração do NLog.
As mensagens de diagnóstico têm como destino uma Base de Dados SQL Server usando uma Stored Procedure para o efeito recorrendo a um wrapper para escrita assíncrona.

public static class MyLog 
    {
        public static ILogger Logger = LogManager.GetCurrentClassLogger();
        private static readonly string _connect = "data source=(localdb)\MSSQLLocalDB;initial catalog=Pluto_Queries;integrated security=True;MultipleActiveResultSets=True;";

        public static void SetDatabaseTarget()
        {
            SetTargetConfiguration();
 
            LogManager.ConfigurationReloaded += (sender, e) =>
            {
                //Re apply if config reloaded
                SetTargetConfiguration();
            };
        }
 
        private static void SetTargetConfiguration()
        {
            var _config = LogManager.Configuration;
 
            var _dbTarget = new DatabaseTarget("sqlserver")
            {
                DBProvider = @"System.Data.SqlClient",
                ConnectionString = _connect,
                CommandType = System.Data.CommandType.StoredProcedure,
                CommandText = @"[dbo].[Write_Info_Pluto]",
            };

            _dbTarget.Parameters.Add(new DatabaseParameterInfo { Name = "@Path", Layout = "${event-properties:path}" });
            _dbTarget.Parameters.Add(new DatabaseParameterInfo { Name = "@FileName", Layout = "${event-properties:fileName}" });
            _dbTarget.Parameters.Add(new DatabaseParameterInfo { Name = "@OnDate", Layout = "${date}" });
 
            var _asyncTarget = new AsyncTargetWrapper("async-db", _dbTarget);
 
            _config.AddTarget(_asyncTarget);
            _config.AddRuleForOneLevel(LogLevel.Info, _asyncTarget);
 
            LogManager.Configuration = _config;
 
            LogManager.ReconfigExistingLoggers();
        }
 
    }

Invocação

MyLog.Logger.Info("Read directory {path}, file {fileName} ", "<nome da directoria>", "<nome do ficheiro>");

O NLog 4.5 introduz o log estruturado - também conhecido por log semântico. Para mais acerca de como usar o log estruturado, ler aqui.
Informação detalhada acerca da renderização das propriedades do evento de log aqui.

Artigo de interesse: NLog vs log4net vs Serilog: Compare .NET Logging Frameworks pela equipa Stackify

The 2019 Backend Technologies Roadmap

Para ler

Registar uma .dll na GAC - O essencial

Para ler

O gacutil.exe é o utilitário .NET para trabalhar com a .

Comandos Principais

A partir da linha de comando do Visual Studio:

Para verificar se uma assembly partilhada na GAC está disponível:

gacutil.exe /l "nome assembly"

Para registar uma assembly partilhada na GAC

gacutil.exe /i "nome assembly"

Para retirar uma assembly partilhada da GAC

gacutil.exe /u "nome assembly"

Mais opções deste utilitário disponíveis usando

gacutil.exe /?

fonte: Wikipedia

Invocar uma Web API em DDD

Para ler

Invocação de Web API em DDD

Console Application

using System.Threading.Tasks;

using WebApiClient.Poc.Core.Interfaces;
using WebApiClient.Poc.Core.Entities;
using WebApiClient.PoC.HttpClientServices.Inventory;
using WebApiClient.PoC.HttpClientServices;

namespace WebApiClient.Poc.Console
{
    class Program
    {
        static void Main(string[] args)
        {
            RunAsync("19072000408").GetAwaiter().GetResult();
        }

        private static async Task RunAsync(string authorCode)
        {
            IAuthorInventoryService _inventoryService = new AuthorInventoryService(new HttpClientWrapper<Author>());
            await _inventoryService.GetInventoryAsync(authorCode);
        }
    }
}

Referência: Call a Web API From a .NET Client (C#)