Identificadores de conta

Um identificador de conta identifica exclusivamente uma conta Snowflake dentro de sua organização, bem como em toda a rede global de plataformas Snowflake com suporte de plataformas de nuvem e regiões de nuvem.

O identificador de conta preferido inclui o nome da conta junto com a organização (por exemplo, myorg-account123). Embora você também possa usar o localizador designado pelo Snowflake como o identificador de conta, o uso desse formato herdado não é recomendado.

Onde são utilizados os identificadores de conta?

São necessários identificadores de conta no Snowflake onde quer que você precise especificar a conta que está usando, inclusive:

  • URLs para acessar qualquer uma das interfaces da web do Snowflake.

  • SnowSQL e outros clientes (conectores, drivers, etc.) para conexão ao Snowflake.

  • Serviços e aplicativos de terceiros que incluem o ecossistema Snowflake.

  • Recursos de segurança para proteger as operações internas do Snowflake e a comunicação/interação com sistemas externos.

  • Recursos globais, como Secure Data Sharing e replicação e Failover/Failback.

Por exemplo, a URL para uma conta usa o seguinte formato:

account_identifier.snowflakecomputing.com

Se sua organização utiliza o recurso Redirecionamento do cliente, o nome de um objeto de conexão pode ser utilizado no lugar do nome da conta no identificador da conta para conectar a uma conta Snowflake utilizando um cliente Snowflake. Para obter mais informações, consulte Uso de uma URL de conexão.

Para obter mais informações sobre o uso de identificadores de conta e conexões para se conectar a uma conta Snowflake, consulte Conexão às suas contas.

Formato 1 (preferido): Nome da conta em sua organização

Uma organização é um objeto Snowflake que vincula as contas de propriedade de sua entidade comercial. Organizações permitem aos administradores da organização (ou seja, usuários com a função ORGADMIN) visualizar, criar e gerenciar todas as suas contas em diferentes plataformas e regiões de nuvem.

Os nomes das contas devem ser únicos dentro de sua organização e podem ser alterados, o que permite maior flexibilidade e leva a nomes de contas mais curtos e mais intuitivos. Você especifica um nome de conta ao criar uma nova conta (consulte Criação de uma conta). Para mudar um nome para uma conta existente, consulte Renomeação de uma conta.

Enquanto um nome de conta identifica de forma única uma conta dentro de sua organização, ele não é um identificador único de uma conta em todas as organizações Snowflake.

Os nomes de contas com sublinhados também têm uma versão tracejada da URL para recursos que não aceitam URLs com sublinhados, como Okta SSO/SCIM.

Uso de um nome de conta como identificador

O identificador de uma conta em sua organização toma uma das seguintes formas, dependendo de onde e como o identificador é utilizado:

  • orgname-account_name (para a maioria dos URLs e outros usos gerais)

  • orgname-account-name (para cenários/recursos em que os sublinhados em um nome de conta não são aceitos)

  • orgname.account_name (para comandos e operações SQL)

Em que:

  • orgname é o nome de sua organização Snowflake.

  • account_name é o nome único de sua conta dentro de sua organização.

Como encontrar o nome da conta e organização de uma conta

Para encontrar o nome de uma conta, você pode usar Snowsight ou SQL.

Snowsight:
  1. Abra o seletor de contas e revise a lista das contas nas quais você fez login anteriormente.

    Captura de tela do seletor de contas aberto e listagem de várias contas. O seletor de conta é rotulado com o nome da conta atualmente selecionada.
  2. Localize a conta para a qual deseja copiar o nome da conta.

  3. Passe o mouse sobre a conta para ver detalhes adicionais e depois selecione o ícone de cópia para copiar o identificador da conta no formato <orgname>.<account_name> para sua área de transferência.

    Captura de tela do seletor de contas aberto e listando várias contas, com um cursor pairando sobre uma conta para exibir um painel adicional de informações sobre a conta e pairando sobre a opção de copiar o identificador da conta.
SQL:

Nomes de conta e organização

Nome da organização

Para os usuários que se inscrevem em uma conta Snowflake usando a opção de autoatendimento, uma organização é criada automaticamente com um nome gerado pelo sistema quando a conta é criada. Para entidades que trabalham diretamente com o pessoal do Snowflake para configurar contas, o Snowflake pode atribuir um nome personalizado à organização. O nome personalizado deve ser único em todas as outras organizações no Snowflake. O nome deve começar com uma letra e só pode conter letras (minúsculas e maiúsculas) e números. O nome não pode conter sublinhados ou outros delimitadores.

Se você quiser mudar o nome de uma organização, por exemplo, mudar de um nome gerado pelo sistema para um nome mais fácil de usar, entre em contato com o suporte Snowflake.

Como melhor prática, revise e mude o nome de sua organização, se necessário, antes de usar o nome em qualquer identificador de conta. Renomear o nome da organização no futuro resultará na mudança de todas as URLs para suas contas Snowflake para corresponder ao novo nome.

Para visualizar o nome de sua organização, consulte Exibição do nome da sua organização e das contas.

Nome da conta

Cada nome de conta deve ser único dentro de sua organização. Você especifica um nome de conta ao criar a conta (consulte Criação de uma conta).

Enquanto um nome de conta identifica de forma única uma conta dentro de sua organização, ele não é um identificador único de uma conta em todas as organizações Snowflake. Para identificar exclusivamente uma conta no Snowflake, é necessário prefixar o nome de sua organização ao nome da conta. Por exemplo:

orgname-account_name

De acordo com as normas SQL para identificadores, os nomes de contas podem incluir sublinhados como separadores entre palavras (por exemplo, MARKETING_TEST_ACCOUNT).

URLs que incluem sublinhados podem às vezes causar problemas para certos recursos, tais como Okta SSO/SCIM. Por esta razão, o Snowflake também suporta uma versão do nome da conta que insere o caractere de hífen (-) no lugar do caractere de sublinhado. Por exemplo, ambas as URLs têm suporte:

URL com sublinhados: https://acme-marketing_test_account.snowflakecomputing.com

URL com traços: https://acme-marketing-test-account.snowflakecomputing.com

Contas existentes

Se você tiver alguma conta que existia antes da ativação do recurso Organizações, o Formato 2 (legado): Localizador de conta em uma região é usado como o nome da conta.

Além disso, se você tiver contas existentes com o mesmo nome em regiões diferentes, os nomes de nuvens e regiões são anexados ao nome da conta no novo formato URL.

Por exemplo, se o nome de sua organização for ACME, e se houver duas contas chamadas TEST, uma na região AWS us-east-2 e outra na região Azure west-us-2, as novas URLs terão a seguinte estrutura:

  • Primeira conta:

    URL original:

    https://test.us-east-2.aws.snowflakecomputing.com

    Nova URL:

    https://acme-test_aws_us_east_2.snowflakecomputing.com

  • Segunda conta:

    URL original:

    https://test.west-us-2.azure.snowflakecomputing.com

    Nova URL:

    https://acme-test_azure_west_us_2.snowflakecomputing.com

Estes nomes de conta podem ser alterados desde que os novos nomes sejam únicos. Para instruções sobre como mudar o nome de uma conta, consulte Renomeação de uma conta.

Formato 2 (legado): Localizador de conta em uma região

Um localizador de conta é um identificador atribuído pelo Snowflake quando a conta é criada:

  • Se a conta for criada por um representante do Snowflake, você poderá solicitar um valor específico para o localizador, como o nome de uma empresa, acrônimo ou outra cadeia de caracteres reconhecível.

  • Se a conta for criada através de autoatendimento ou de um processo automatizado/em segundo plano, o localizador será uma sequência aleatória de caracteres e números únicos (por exemplo, xy12345).

O localizador de uma conta não poderá ser alterado uma vez que a conta for criada.

Nota

Os localizadores de conta continuam a ter suporte para identificar contas no Snowflake, mas este já não é o método preferido. O método preferido para identificar contas agora é o nome da conta dentro de sua organização (como descrito anteriormente neste tópico).

Uso de um localizador de contas como identificador

Cada conta Snowflake é hospedada em uma plataforma de nuvem em uma região geográfica.

A região determina onde os dados da conta são armazenados e onde os recursos computacionais utilizados pela conta são provisionados.

Ao usar um localizador de conta para identificar uma conta, o localizador por si só nem sempre é suficiente para identificar a conta. Dependendo da região e da plataforma de nuvem para a conta, segmentos adicionais podem ser necessários, sob a forma de:

account_locator.cloud_region_id ou

account_locator.cloud_region_id.cloud

Em que:

  • cloud_region_id é o identificador da região da nuvem (ditado pela plataforma de nuvem).

  • cloud é o identificador da plataforma de nuvem (aws, azure ou gcp).

Por exemplo, se o localizador de sua conta for xy12345:

  • Se a conta estiver localizada na região AWS US West (Oregon), não são necessários segmentos adicionais e a URL seria xy12345.snowflakecomputing.com.

  • Se a conta estiver localizada na região AWS US East (Ohio), são necessários segmentos adicionais e a URL seria xy12345.us-east-2.aws.snowflakecomputing.com.

Para uma lista completa de regiões e formatos de localizadores, consulte Formatos de localizador de conta não VPS por plataforma de nuvem e região (neste tópico).

Nota

Se sua edição do Snowflake for VPS, o localizador de contas usa um formato diferente. Consulte Como encontrar o formato do localizador de conta para uma conta VPS (neste tópico).

Como encontrar a região e o localizador para uma conta

Se você pode se conectar à sua conta Snowflake, pode consultar as seguintes funções de contexto para identificar a região e o localizador de conta para a conta Snowflake à qual você está conectado:

Se você não conseguir se conectar ao Snowflake, entre em contato com o administrador do Snowflake para obter estas informações.

Como encontrar o formato do localizador de conta para uma conta VPS

Se sua edição do Snowflake for VPS, o formato do localizador de conta usa convenções de nomenclatura diferentes das contas de outras edições do Snowflake. Isto resulta em uma estrutura diferente para os nomes de host e URLs usados para acessar contas VPS.

Para obter mais detalhes, entre em contato com o suporte Snowflake ou seu representante Snowflake.

Como alternativa, você pode usar o formato preferido de organization_name-account_name como identificador de sua conta. Este formato funciona para contas que utilizam a edição VPS. Para obter mais detalhes, consulte Formato 1 (preferido): Nome da conta em sua organização (neste tópico).

Formatos de localizador de conta não VPS por plataforma de nuvem e região

A tabela a seguir lista os formatos do localizador de conta em todas as regiões nãoVPS com suporte, incluindo se o localizador de conta para uma determinada região requer segmentos adicionais:

Se o localizador de sua conta for xy12345:

Plataforma de nuvem/Região

Identificador da conta

Notas

Amazon Web Services (AWS)

US West (Oregon)

xy12345

Não são necessários segmentos adicionais.

US Gov West 1

xy12345.us-gov-west-1.aws

US Gov West 1 (FedRAMP High Plus)

xy12345.fhplus.us-gov-west-1.aws

US East (Ohio)

xy12345.us-east-2.aws

US East (N. Virginia)

xy12345.us-east-1

A ID da região da nuvem é o único segmento adicional necessário.

US East (Commercial Gov - N. Virginia)

xy12345.us-east-1-gov.aws

Canada (Central)

xy12345.ca-central-1.aws

South America (Sao Paulo)

xy12345.sa-east-1.aws

EU (Irlanda)

xy12345.eu-west-1

A ID da região da nuvem é o único segmento adicional necessário.

Europe (London)

xy12345.eu-west-2.aws

EU (Paris)

xy12345.eu-west-3.aws

EU (Frankfurt)

xy12345.eu-central-1

A ID da região da nuvem é o único segmento adicional necessário.

EU (Stockholm)

xy12345.eu-north-1.aws

Asia Pacific (Tokyo)

xy12345.ap-northeast-1.aws

Asia Pacific (Osaka)

xy12345.ap-northeast-3.aws

Asia Pacific (Seoul)

xy12345.ap-northeast-2.aws

Asia Pacific (Mumbai)

xy12345.ap-south-1.aws

Asia Pacific (Singapore)

xy12345.ap-southeast-1

A ID da região da nuvem é o único segmento adicional necessário.

Asia Pacific (Sydney)

xy12345.ap-southeast-2

A ID da região da nuvem é o único segmento adicional necessário.

Ásia Pacífico (Jakarta)

xy12345.ap-southeast-3.aws

Google Cloud Platform (GCP)

US Central1 (Iowa)

xy12345.us-central1.gcp

US East4 (N. Virginia)

xy12345.us-east4.gcp

Europe West2 (London)

xy12345.europe-west2.gcp

Europe West4 (Netherlands)

xy12345.europe-west4.gcp

Microsoft Azure

Os localizadores de conta Azure foram implementados com hifens para consistência com AWS e GCP.

West US 2 (Washington)

xy12345.west-us-2.azure

Central US (Iowa)

xy12345.central-us.azure

South Central US (Texas)

xy12345.south-central-us.azure

East US 2 (Virginia)

xy12345.east-us-2.azure

US Gov Virginia

xy12345.us-gov-virginia.azure

Canada Central (Toronto)

xy12345.canada-central.azure

UK Sul (Londres)

xy12345.uk-south.azure

North Europe (Ireland)

xy12345.north-europe.azure

West Europe (Netherlands)

xy12345.west-europe.azure

Norte da Suíça (Zurique)

xy12345.switzerland-north.azure

Norte dos UAE (Dubai)

xy12345.uae-north.azure

Central India (Pune)

xy12345.central-india.azure

Japan East (Tokyo)

xy12345.japan-east.azure

Southeast Asia (Singapore)

xy12345.southeast-asia.azure

Australia East (New South Wales)

xy12345.australia-east.azure

Identificadores de conta para conectividade privada

Se a conectividade privada ao serviço Snowflake estiver habilitado para sua conta e você desejar usar o recurso para conectar ao Snowflake, execute a função SYSTEM$GET_PRIVATELINK_CONFIG para determinar a URL de conectividade privada a ser usada. Você pode usar o nome da conta ou o localizador de conta na URL para se conectar à interface da Web do Snowflake.

Se você quiser se conectar a Snowsight usando conectividade privada, use as instruções a seguir em Como fazer login no Snowsight.

Identificadores de conta para replicação e failover

O método preferido para identificar uma conta nos comandos SQL relacionados à replicação e failover é usar o nome da organização e o nome da conta como o identificador da conta. Se, em vez disso, você decidir usar o localizador de conta herdado, pode ser necessário que ele contenha segmentos adicionais para identificar a conta de forma única. Consulte a tabela abaixo para referência:

Identificador da conta

Localização da conta remota

organization_name.account_name

Identificador de conta preferido que pode ser usado independentemente da região ou grupo de regiões da conta que armazena o banco de dados primário.

account_locator

A mesma região, mas uma conta diferente da conta que armazena o banco de dados primário.

snowflake_region.account_locator

O mesmo grupo regional, mas uma região diferente da conta que armazena o banco de dados primário.

region_group.snowflake_region.account_locator

Grupo de regiões diferente da conta que armazena o banco de dados primário.

O valor para snowflake_region e region_group pode ser encontrado na saída de SHOW REPLICATION ACCOUNTS.

IDs da região Snowflake e grupos de regiões

Uma região Snowflake é uma região distinta (implantada dentro de uma região de nuvem AWS, Azure ou GCP) que está isolada de outras regiões Snowflake. Uma região Snowflake pode ser multilocatária (contendo contas para várias organizações) ou unilocatária (conhecida também como Virtual Private Snowflake para uma única organização).

Cada região Snowflake tem um identificador único e pertence a um grupo de regiões, o que habilita recursos globais, tais como compartilhamento e replicação de dados.

IDs de região

Como cada plataforma de nuvem utiliza convenções e formatos diferentes para nomear suas regiões, o Snowflake atribui uma ID canônica a cada região Snowflake que a identifica de forma única em todas as plataformas de nuvem e suas regiões.

Se o recurso Organizações estiver habilitado, é necessário especificar a ID da região Snowflake como parte de um identificador de conta quando você criar uma nova conta, bem como quando você configurar a replicação e o failover.

A tabela a seguir exibe a lista completa de IDs de região Snowflake:

Região de nuvem

ID da região da nuvem 

ID da região Snowflake 

Notas

Amazon Web Services (AWS)

US West (Oregon)

us-west-2

aws_us_west_2

US Gov West 1

us-gov-west-1

aws_us_gov_west_1

Disponível somente para contas Business Critical (ou superior); localizadas em AWS GovCloud (US).

US Gov West 1 (FedRAMP High Plus)

fhplus.us-gov-west-1.aws

aws_us_gov_west_1_fhplus

Disponível somente para contas Business Critical (ou superior); localizadas em AWS GovCloud (US).

US East (Ohio)

us-east-2

aws_us_east_2

US East (N. Virginia)

us-east-1

aws_us_east_1

US East (Commercial Gov - N. Virginia)

us-east-1

aws_us_gov_east_1

Disponível apenas para contas Business Critical (ou superior); localizadas em US East 1, não AWS GovCloud (US).

Canada (Central)

ca-central-1

aws_ca_central_1

South America (Sao Paulo)

sa-east-1

aws_sa_east_1

EU (Irlanda)

eu-west-1

aws_eu_west_1

Europe (London)

eu-west-2

aws_eu_west_2

EU (Paris)

eu-west-3

aws_eu_west_3

EU (Frankfurt)

eu-central-1

aws_eu_central_1

EU (Stockholm)

eu-north-1

aws_eu_north_1

Asia Pacific (Tokyo)

ap-northeast-1

aws_ap_northeast_1

Asia Pacific (Osaka)

ap-northeast-3

aws_ap_northeast_3

Asia Pacific (Seoul)

ap-northeast-2

aws_ap_northeast_2

Asia Pacific (Mumbai)

ap-south-1

aws_ap_south_1

Asia Pacific (Singapore)

ap-southeast-1

aws_ap_southeast_1

Asia Pacific (Sydney)

ap-southeast-2

aws_ap_southeast_2

Ásia Pacífico (Jakarta)

ap-southeast-3

aws_ap_southeast_3

Google Cloud Platform (GCP)

US Central1 (Iowa)

us-central1

gcp_us_central1

US East4 (N. Virginia)

us-east4

gcp_us_east4

Europe West2 (London)

europe-west2

gcp_europe_west2

Europe West4 (Netherlands)

europe-west4

gcp_europe_west4

Microsoft Azure

West US 2 (Washington)

westus2

azure_westus2

Central US (Iowa)

centralus

azure_centralus

South Central US (Texas)

southcentralus

azure_southcentralus

East US 2 (Virginia)

eastus2

azure_eastus2

US Gov Virginia

usgovvirginia

azure_usgovvirginia

Disponível somente para contas Business Critical (ou superior); localizadas em Microsoft Azure Government.

Canada Central (Toronto)

canadacentral

azure_canadacentral

UK Sul (Londres)

uk-south

azure_uksouth

North Europe (Ireland)

northeurope

azure_northeurope

West Europe (Netherlands)

westeurope

azure_westeurope

Norte da Suíça (Zurique)

switzerlandnorth

azure_switzerlandnorth

Norte dos UAE (Dubai)

uaenorth

azure_uaenorth

Central India (Pune)

central-india.azure

azure_centralindia

Japan East (Tokyo)

japaneast

azure_japaneast

Southeast Asia (Singapore)

southeastasia

azure_southeastasia

Australia East (New South Wales)

australiaeast

azure_australiaeast

Grupos de regiões

Um grupo de regiões é um grupo de regiões Snowflake que oferecem controles de segurança, isolamento e conformidade similares. O grupo de regiões ao qual pertence uma região Snowflake difere dependendo da região:

  • Todas as regiões comerciais Snowflake multilocatárias (em todas as plataformas de nuvem com suporte) estão no mesmo grupo PUBLIC compartilhado/geral.

  • Cada região governamental Snowflake multilocatária está em um grupo separado específico para a região.

  • Cada Virtual Private Snowflake unilocatário (VPS) está em um grupo de regiões separado específico para o VPS. Se sua organização tem mais de um VPS, você pode ter um VPS por grupo de região ou múltiplos VPSs podem compartilhar o mesmo grupo de região.

A especificação do grupo de regiões como parte de um identificador de conta é necessária quando se deseja criar contas em diferentes grupos de regiões.