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:

Abra o seletor de contas e revise a lista das contas nas quais você fez login anteriormente.
Localize a conta para a qual deseja copiar o nome da conta.
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.

SQL:

Para recuperar o nome da conta atual, execute a função CURRENT_ACCOUNT_NAME.
Para recuperar a organização da conta atual, execute a função CURRENT_ORGANIZATION_NAME.

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:

CURRENT_REGION recupera a região em que sua conta está localizada.
CURRENT_ACCOUNT recupera o localizador de conta.

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.

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.