Tutorial - forma mais rápida de criar uma base de dados de exemplo

 Introdução

Esse é um tutorial simples da forma mais rápida que eu achei para criar uma base de dados de exemplo para quaisquer razões, como realizar testes, fazer exemplos para tutoriais, etc.

Criando um namespace

1. Abra o terminal
2. Escreva o comando "D $SYSTEM.SQL.Shell()"
3. Escreva"CREATE DATABASE " e o nome desejado para o namespace.

Agora você tem um namespace novo de uma forma muito mais rápida que criando pelo Portal de Administração - que é claro que oferece muito mais opções de configuração.

Para selecioná-lo, saia do Shell SQL escrevendo "q" e então digitando 'zn "nomeDoNamespace". Agora tudo que você fizer no terminal será no escopo desse namespace.

Criando a base de dados

1. Abra o terminal
2. Abra o SQL Shell com "D $SYSTEM.SQL.Shell()"
3. Entre no modo multilinhas pressionando enter
4. Escreva o código de acordo com o exemplo a seguir:

5. [SQL]SAMPLE>>  << entering multiline statement mode, 'GO' to execute >>
       1>>CREATE TABLE Sample.PersitentData (
       2>>Name %String,
       3>>Age %Integer )
       4>>GO

   Você pode especificar as propriedades com os nomes que quiser e tipos do IRIS (como %String) ou do SQL (como VARCHAR), escolha o que você se sentir mais confortável. Você também pode definir muitas configurações dentro desse código, como você pode ver em CREATE TABLE (SQL), mas o objetivo desse artigo é fazer tudo da forma mais simples possível.

Agora você pode ver sua classe no Portal de Administração, Studio, VS Code ou acessá-la pelo terminal, com o nome e package que colocou no lugar de "Sample.PersistentData" no exemplo.

Populando a tabela

Uma vez que você tem uma tabela criada, acesse o código fonte da classe pelo Studio ou VS Code e adicione %Populate aos parâmetros de "Extends".

A assinatura da classe deve se parecer com essa:

Class Sample.PersistentData Extends (%Persistent, %Populate)

claro, com qualquer outras classes que queira extender - %JSON.Adaptor e %XML.Adaptor pode ser útil para exportar dados, vê-los no portal de produções, etc.

Agora você pode abrir o terminal e executar o seguinte código, substituindo "100" pelo número de linhas que você quer:

D #class(Sample.PersistentData).Populate(100)

Note que, para este exemplo, só temos a especificação que a idade é um inteiro, então os números gerados podem não ter sentido semântico. Aqui foi o meu resultado:

É possível arrumar isso mexendo nas definições da tabela, mas já que o objetivo desse artigo é fazer tudo da forma mais simples possível, eu simplesmente rodei o código:

UPDATE Sample.PersistentData
SET Age = Age # 120

Conclusão

Embora o tutorial possa não parecer tão curto, tendo aprendido todos esses passos, eu os utilizo para testar ideias que quero trazer para a empresa e para criar exemplos para os artigos que eu escrevo aqui - talvez você já tenha lido algo que eu escrevi! - e levo apenas por volta de um minuto para ter uma base de dados bem estruturada e focar em desenvolver o conteúdo em si.