Partilhar via


Criar arquivos de valor variável (AccessToSQL)

Um Arquivo de Valor Variável corresponde a um arquivo XML que contém valores de parâmetros de comandos (como o nome do servidor de destino ou de origem) que sofrem alterações frequentemente nas migrações de servidor. Quando ocorre um número grande de migrações de banco de dados, vários arquivos variáveis ​​para o armazenamento do valor de cada servidor de origem são criados e referenciados em um arquivo de script mestre com a opção -v na linha de comando. Esse comportamento ajuda a manter valores estáticos em alguns arquivos de script com os valores variáveis ​​em vários arquivos variáveis.

Observação

  • Os nomes das variáveis são prefixados e sufixados com um símbolo $ (dólar). Se um valor não for atribuído a uma variável no arquivo de valor da variável, ocorrerá um erro durante a análise do arquivo de script, resultando na paralisação do processo de execução do console.
  • O caractere de escape para $ é $$. Se o valor de uma variável ou de um valor estático para um parâmetro contiver um símbolo $ (dólar), $$ deverá ser especificado para tratá-lo como um caractere em vez de uma variável.
  • Para fins de manutenção, as variáveis podem ser declaradas em elementos 'variable-group' para separação lógica de variáveis definidas pelo usuário. O uso deste elemento não é obrigatório.

Exemplos:

Exemplo 1:

<!--Sample of variable value file commands-->  
  
<variables>  
  
  <variable-group name="ProjectSpecs">  
  
    <variable name="$type$" value="MyProject"/>  
  
    <variable name="$project_folder$" value=".\$project_name$"/>  
  
    <variable name="$project_name$" value="$type$ConsoleProject"/>  
  
    <variable name="$project_overwrite$" value="true"/>  
  
    <variable name="$project_type$" value="sql-server-2008"/>  
  
  </variable-group>  
  
</variables>  

Exemplo 2:

<!--Sample of variable value file commands-->  
  
<variables>  
  
  <variable-group name="SQLServerParams">  
  
    <variable-group name="SqlServerConnectionParams">  
  
      <variable name="$TargetServerName$" value="xxx"/>  
  
      <variable name="$TargetDB$" value="xxx"/>  
  
      <variable name="$TargetUserName$" value="xxx"/>  
  
      <variable name="$TargetPassword$" value="xxx"/>  
  
      <variable name="$TargetIsTrusted$" value="xxx"/>  
  
      <variable name="$TrustedConnection$" value="xxx"/>  
  
    </variable-group>  
  
    <variable-group name="SqlServerObjectParams">  
  
      <variable name="$ObjectName1$" value="TestTable1"/>  
  
      <variable name="$ObjectName2$" value="TestProc1"/>  
  
    </variable-group>  
  
  </variable-group>  
  
</variables>  

Validação de arquivo de valor variável

O usuário pode validar com facilidade seu arquivo de valor variável em relação ao arquivo de definição de esquema ConsoleScriptVariablesSchema.xsd disponível na pasta “Esquemas”.

Próxima etapa

A próxima etapa na operação do console é Criar arquivos de conexão do servidor (AccessToSQL).

Confira também

Criar arquivos de conexão do servidor (Access)