Calcular Campo

Anotação:

Esta ferramenta está disponível apenas no ModelBuilder.

A ferramenta Calcular Campo usa uma expressão SQL para calcular valores para um campo novo ou existente. Substituir um campo no conjunto de dados de saída não afetará os valores do campo no conjunto de dados de entrada.

A saída é uma variável de dados de saída que pode ser configurada como uma camada intermediária ou uma camada hospedada.

Exemplos

Os exemplos de uso dessa ferramenta incluem o seguinte:

• Um conjunto de dados inclui campos para o número de edifícios residenciais com painéis solares no telhado e o número total de edifícios residenciais por bairro. Calcular Campo pode ser usada para criar um novo campo e calcular a taxa de absorção solar em cada bairro.
• Um conjunto de dados inclui um campo numérico onde -9999 foi usado como um valor de espaço reservado, o que impactaria os resultados da análise se esse campo fosse usado como uma entrada. Calcular campo pode ser usado para alterar o valor do campo para um valor padrão apropriado para o subconjunto de registros com o espaço reservado -9999.

Anotações de uso

Calcular Campo inclui configurações para a entrada, cálculo de campo e camada resultante.

Entrada

O grupo Entrada inclui os seguintes parâmetros:

• O Conjunto de dados de entrada especifica se a entrada é uma camada de feição hospedada ou uma camada de tabela hospedada. Você pode escolher um conjunto de dados clicando em Camada .

• Aplicar cálculos somente a determinados registros define os critérios que determinam qual subconjunto de registros terá o cálculo de campo aplicado. Estas feições que atendem todos os critérios serão incluídas no subconjunto. Para definir uma consulta, clique em Criar nova consulta. Um conjunto de dados de entrada deve ser especificado para editar a expressão.

  Para aplicar o cálculo a todos os registros, deixe este parâmetro em branco.

  Saiba mais sobre como criar uma consulta

Cálculo de campo

O grupo Cálculo de campo inclui os seguintes parâmetros:

• Campo para calcular especifica o campo no qual os valores calculados serão adicionados. Você pode escolher em uma lista de campos existentes ou criar um novo campo.

  Se um campo existente for escolhido, todos os valores atualmente dentro do campo serão substituídos.

  Anotação:

  Calcular campo cria um novo conjunto de dados de saída. Substituir um campo no conjunto de dados de saída não afetará os valores do campo no conjunto de dados de entrada.

  Para criar um novo campo, clique em Criar novo campo e forneça o seguinte:
  • Nome do campo — Digite um nome para o novo campo. O nome do campo não pode ser o mesmo que um nome do campo existente na camada, não pode conter caracteres especiais ou espaços e não pode ser uma palavra-chave SQL.
  • Tipo de campo—Selecione um tipo de campo no menu. O tipo de campo determinará quais tipos de dados e expressões são suportados para calcular o campo. Os seguintes tipos de campo são suportados:
    • Duplo—Números com casas decimais.
    • Inteiro—Números inteiros de -2,147,483,648 até 2,147,483,647 (inteiro longo).
    • Inteiro Grande—Números inteiros de -9,007,199,254,740,991 até 9,007,199,254,740,991. Use esse tipo quando precisar armazenar números que não cabem no intervalo do tipo de dados inteiro.
    • String—Qualquer sequência de caracteres.
    • Data—Data e hora.
    • Somente Data—Armazena uma data, mas nenhum valor de hora. Isso é útil quando os horários não são necessários, como ao registrar o dia em que uma permissão expira.
    • Somente Hora—Armazena uma hora, mas nenhum valor de data. O formato da hora é determinado pelas configurações do usuário. Este tipo de dado de campo é útil para registrar valores como horário de partida.

• A expressão de cálculo de campo define uma expressão SQL usada para calcular valores de Campo para calcular. Clique em Expressão para abrir a janela Editor de expressões SQL. Na janela do editor de expressões SQL, use Campos , Funções e operadores básicos para criar uma expressão válida.

  Saiba mais sobre como escrever expressões SQL

  Se a saída da expressão e o tipo de campo forem parcialmente compatíveis (por exemplo, os tipos de campo duplo e inteiro suportam saídas numéricas, mas com restrições diferentes), os valores serão transformados automaticamente para atender aos requisitos do tipo de campo. A transformação ocorrerá automaticamente e sem nenhuma notificação.

  A tabela a seguir descreve como certas saídas serão transformadas para corresponder ao tipo de campo:

  Saída	Tipo de campo	Transformação
  Duplo	Inteiro	Arredondar para o número inteiro mais próximo
  Somente Data	Data	Anexar 12:00 a.m. UTC a cada data
  Data	Somente Data	Converter a data e a hora para UTC e armazenar a data.
  Data	Somente Hora	Converter a data e a hora para UTC e armazenar a hora.

Camada resultante

O grupo de Camada de resultado inclui os seguintes parâmetros:

• O Tipo de resultado especifica se a saída é uma camada intermediária ou uma camada de feição hospedada. As seguintes opções estão disponíveis:
  • Criar dados intermediários cria um conjunto de dados temporário que pode ser usado como entrada para outro elemento de ferramenta. Este é o padrão para todas as ferramentas em um modelo.
  • Criar camada hospedada cria uma nova camada hospedada para o conjunto de dados de saída. Se esta opção for escolhida, os seguintes parâmetros estarão disponíveis:
    • Nome de saída especifica o nome da camada que é criada e adicionada e exibida. O nome deve ser único. Se já existir uma camada com o mesmo nome em sua organização, a ferramenta falhará e você será solicitado a usar um nome diferente.
    • Se existir uma camada com o mesmo nome, substituí-la automaticamente determina se o modelo pode ser executado novamente sem alterar o nome da camada de saída. Se a camada ainda não existir na organização, uma nova camada será criada na primeira execução do modelo e será substituída nas execuções subsequentes do modelo. O parâmetro é habilitado por padrão.
    • Salvar na pasta especifica o nome de uma pasta em Meu conteúdo onde o resultado será salvo.
  • Substituir camada existente especifica uma camada hospedada existente que será substituída pela saída da ferramenta. Se esta opção for escolhida, o parâmetro Camada a ser substituída também estará disponível para navegar até uma camada existente.

Saiba mais sobre as saídas do modelo

Limitações

As seguintes limitações se aplicam à ferramenta:

• Calcular Campo está disponível somente no ModelBuilder. Se você não estiver usando ModelBuilder, você poderá calcular valores de campo no Map Viewer.
• Expressões espaciais não são suportadas.
• Listas de valores de campo não estão disponíveis no construtor de consultas quando a camada de entrada ou tabela é uma saída de outra ferramenta.
• Se um valor calculado para um campo de texto ou número exceder os limites de comprimento do campo, a saída aparecerá como nula para novos campos ou manterá o valor do campo de entrada para os campos existentes.
• Cálculos de campo que utilizam campos de entrada e saída incompatíveis podem produzir resultados inesperados. Por exemplo, usar um campo "Somente Hora" para calcular uma saída "Somente Data" resultará na data 1899-12-30 para todos os campos. Outras combinações de campos incompatíveis incluem entradas somente de hora com saídas de data e entradas somente de data com saídas somente de hora.

Ambientes

Esta ferramenta não respeita ambientes de análise.

Créditos

Esta ferramenta não consome créditos.

Saídas

Calcular Campo cria uma variável de dados de saída que pode ser dados intermediários ou hospedados. O conjunto de dados de saída tem a mesma geometria e campos que o conjunto de dados de entrada, a menos que um novo campo seja adicionado para o cálculo.

Anotação:

Calcular campo cria um novo conjunto de dados de saída. Substituir um campo no conjunto de dados de saída não afetará os valores do campo no conjunto de dados de entrada.

Requisitos de licenciamento

Esta ferramenta requer o seguinte tipo de usuário e configurações:

• Professional ou tipo de usuário Professional Plus
• Papel de Publisher, Facilitator ou Administrator, ou um papel personalizado equivalente

Recursos

Utilize os seguintes recursos para saber mais:

• Como construir uma consulta
• Calcular valores de campo (Map Viewer)
• Calcular campo no ArcGIS Data Pipelines
• Calcular Campo no ArcGIS Pro