View a markdown version of this page

CREATE IDENTITY PROVIDER - Amazon Redshift
SintaxeParâmetrosExemplo

O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na publicação do blog publicada em 30 de junho de 2025.

CREATE IDENTITY PROVIDER

Define um novo provedor de identidades. Somente um superusuário pode criar um provedor de identidades.

Sintaxe

CREATE IDENTITY PROVIDER identity_provider_name TYPE type_name
NAMESPACE namespace_name
[PARAMETERS parameter_string]
[APPLICATION_ARN arn]
[IAM_ROLE iam_role]
[AUTO_CREATE_ROLES
    [ TRUE [ { INCLUDE | EXCLUDE } GROUPS LIKE filter_pattern] |
      FALSE
    ]
  ];

Parâmetros

identity_provider_name

O nome do provedor de identidades. Para obter mais informações sobre nomes válidos, consulte Nomes e identificadores.

type_name

O provedor de identidades com o qual interagir. No momento, o AWSIDC é o único provedor de identidades compatível.

namespace_name

O namespace. Esse é um identificador exclusivo abreviado para o diretório do provedor de identidades.

parameter_string

Uma string com um objeto JSON formatado corretamente que contém os parâmetros e valores necessários para o provedor de identidades.

arn

O nome do recurso da Amazon (ARN) para uma aplicação gerenciada pelo Centro de Identidade do IAM. Esse parâmetro é aplicável somente quando o tipo de provedor de identidades é AWSIDC.

iam_role

O perfil do IAM que fornece permissões para fazer a conexão com o Centro de Identidade do IAM. Esse parâmetro é aplicável somente quando o tipo de provedor de identidades é AWSIDC.

auto_create_roles

Habilita ou desabilita o atributo de criação automática de perfil. Se o valor for TRUE, o Amazon Redshift habilitará o recurso de criação automática de perfil. Se o valor for FALSE, o Amazon Redshift desabilitará o recurso de criação automática de perfil. Se o valor desse parâmetro não for especificado, o Amazon Redshift o determinará usando a seguinte lógica:

  • Se AUTO_CREATE_ROLES for habilitado, mas o valor não for especificado, o valor será definido como TRUE.

  • Se AUTO_CREATE_ROLES não for habilitado e o provedor de identidades for AWSIDC, o valor será definido como FALSE.

  • Se AUTO_CREATE_ROLES não for habilitado e o provedor de identidades for o Azure, o valor será definido como TRUE.

Para incluir grupos, especifique INCLUDE. O padrão é vazio, o que significa incluir todos os grupos se AUTO_CREATE_ROLES estiver ativado.

Para excluir grupos, especifique EXCLUDE. O padrão é vazio, o que significa não excluir nenhum grupo se AUTO_CREATE_ROLES estiver ativado.

filter_pattern

Uma expressão de caractere UTF-8 válida com o padrão para estabelecer correspondência com os nomes de grupo. A opção LIKE executa uma correspondência com distinção entre letras maiúsculas e minúsculas compatível com os seguintes metacaracteres de correspondência de padrões:

Metacaractere Descrição
% Corresponde a qualquer sequência de zero ou mais caracteres.
_ Corresponde a qualquer caractere único.

Se filter_pattern não contiver metacaracteres, o padrão representará somente a própria string. Nesse caso, LIKE age da mesma forma que o operador de igualdade.

filter_pattern aceita os seguintes caracteres:

  • Caracteres alfabéticos maiúsculos e minúsculos (A-Z e a-z)

  • Números (0-9)

  • Os seguintes caracteres especiais: 

    _ % ^ * + ? { } , $

Exemplos

O exemplo a seguir cria um provedor de identidades chamado oauth_standard, com um TYPE Azure, para estabelecer comunicação com o Microsoft Azure Active Directory (AD).

CREATE IDENTITY PROVIDER oauth_standard TYPE azure
NAMESPACE 'aad'
PARAMETERS '{"issuer":"https://sts.windows.net/2sdfdsf-d475-420d-b5ac-667adad7c702/",
"client_id":"87f4aa26-78b7-410e-bf29-57b39929ef9a",
"client_secret":"BUAH~ewrqewrqwerUUY^%tHe1oNZShoiU7",
"audience":["https://analysis.windows.net/powerbi/connector/AmazonRedshift"]
}'

Você pode conectar uma aplicação gerenciada pelo Centro de Identidade do IAM a um cluster provisionado ou um grupo de trabalho existente do Amazon Redshift sem servidor. Isso permite gerenciar o acesso a um banco de dados do Redshift por meio do Centro de Identidade do IAM. Para fazer isso, execute um comando SQL de acordo com o exemplo a seguir. Você deve ser administrador de banco de dados.

CREATE IDENTITY PROVIDER "redshift-idc-app" TYPE AWSIDC
NAMESPACE 'awsidc'
APPLICATION_ARN 'arn:aws:sso::123456789012:application/ssoins-12345f67fe123d4/apl-a0b0a12dc123b1a4'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyRedshiftRole';

O ARN da aplicação, nesse caso, identifica a aplicação gerenciada à qual se conectar. Você pode encontrá-la executando SELECT * FROM SVV_IDENTITY_PROVIDERS;.

Para obter mais informações sobre como usar CREATE IDENTITY PROVIDER, incluindo exemplos adicionais, consulte Federação de um provedor de identidades (IdP) nativo para o Amazon Redshift. Para obter mais informações sobre a configuração de uma conexão do Redshift ao Centro de Identidade do IAM, consulte Conectar o Redshift ao IAM Identity Center para proporcionar aos usuários uma experiência de logon único.