As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Empregos em AWS Data Exchange
AWS Data Exchange as tarefas são operações assíncronas de importação ou exportação.
Como provedor, você pode criar e gerenciar os conjuntos de dados que deseja publicar em um produto. Você pode baixar (exportar) ou copiar seus ativos ou revisões para o Amazon Simple Storage Service (Amazon S3) ou para um documento assinado. URL Além disso, os provedores podem importar ativos de um Amazon API Gateway API ou importar ativos de um conjunto de dados do Amazon Redshift.
Como assinante, você pode visualizar e acessar os conjuntos de dados aos quais tem direito por meio de uma assinatura. Você pode usar as API operações para baixar (exportar) ou copiar seus conjuntos de dados autorizados para o Amazon S3 para uso com uma variedade de serviços de AWS análise e aprendizado de máquina.
Para criar ou copiar ativos ou copiar revisões por meio de trabalhos, você pode usar o AWS Management Console, AWS Command Line Interface (AWS CLI), seu próprio REST aplicativo ou um dos AWS SDKs.
Os trabalhos são excluídos 90 dias após serem criados.
Tópicos
Propriedades do trabalho
Os trabalhos são compatíveis com as seguintes propriedades:
-
Job ID — Um ID gerado quando o trabalho é criado e que identifica o trabalho de forma exclusiva.
-
Job type — Os seguintes tipos de trabalho são compatíveis:
-
Importar do Amazon S3
-
Importar uma permissão de dados AWS Lake Formation (Visualização)
-
Importar de assinado URL
-
Importar do Amazon API Gateway API
-
Importar de um compartilhamento de AWS Data Exchange dados para o Amazon Redshift
-
Importar um acesso aos dados do Amazon S3
-
Exportar para o Amazon S3.
-
Exportar para assinado URL
-
-
Amazon Resource Name (ARN) — Um identificador exclusivo para AWS recursos.
-
Estado do trabalho — Os estados do trabalho são
WAITING
,IN_PROGRESS
,COMPLETED
,CANCELLED
,ERROR
ouTIMED_OUT
. Quando um trabalho é criado, ele fica no estadoWAITING
até que o trabalho seja iniciado. -
Detalhes do trabalho — Informações da operação a ser executada pelo trabalho, como informações de destino de exportação ou informações de origem de importação.
exemplo recurso de trabalho
{ "Arn": "arn:aws:dataexchange:us-east-1:
123456789012
:jobs/6cEXAMPLE818f7c7a23b3d0EXAMPLE1c
", "Id": "6cEXAMPLE818f7c7a23b3d0EXAMPLE1c
", "State": "COMPLETED", "Type": "IMPORT_ASSETS_FROM_S3", "CreatedAt": "2019-10-11T14:12:24.640Z", "UpdatedAt": "2019-10-11T14:13:00.804Z", "Details": { "ImportAssetsFromS3": { "AssetSources": [ { "Bucket": "amzn-s3-demo-bucket", "Key": "MyKey
" } ], "DataSetId": "14EXAMPLE4460dc9b005a0dEXAMPLE2f", "RevisionId": "e5EXAMPLE224f879066f999EXAMPLE42" } } }
Regiões da AWS e empregos
Se você importar ou exportar um ativo para ou de um bucket do Amazon S3 que esteja em uma Região da AWS região diferente da região do conjunto de dados, você será cobrado pelos custos de transferência de dados Conta da AWS , de acordo com as políticas de preços de transferência de dados do Amazon S3.
Se você exportar ativos para um site assinadoURL, você será Conta da AWS cobrado pelos custos de transferência de dados do Amazon S3 para a Internet, de acordo com as políticas de preços do Amazon S3
Quando sua assinatura de um conjunto de dados AWS Data Exchange for Files termina, você mantém o acesso a todos os arquivos que já exportou. Revise seu Contrato de Assinatura de Dados para verificar se ele exige que você exclua os dados exportados ao encerrar uma assinatura.
Importar ativos
Você pode importar ativos para uma revisão das seguintes maneiras:
Tópicos
Importar ativos de um bucket do S3
Quando você importa ativos do Amazon S3 para AWS Data Exchange, as permissões AWS Identity and Access Management (IAM) que você usa devem incluir a capacidade de gravar nos buckets do S3 do AWS Data Exchange serviço e ler do bucket do S3 onde seus ativos estão armazenados. Você pode importar de qualquer bucket do S3 ao qual tenha permissão de acesso, independentemente da propriedade. Para obter mais informações, consulte Permissões do Amazon S3.
Você pode importar até 100 ativos em um único trabalho.
Tópicos
Importação de ativos de um bucket do S3 ()AWS SDKs
Para importar ativos de um bucket do Amazon S3 ()AWS SDKs
-
Crie uma solicitação
CreateJob
do tipoIMPORT_ASSETS_FROM_S3
. -
Inclua o seguinte na solicitação:
-
AssetSources
-
Bucket
-
Key
-
-
DataSetID
-
RevisionID
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que requer o retornoJobId
na etapa 1. -
(Opcional) Atualize a propriedade do nome dos ativos após a criação.
Importar ativos de um bucket do S3 (console)
Para importar um ativo de um bucket do S3 (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados de propriedade, selecione o conjunto de dados que tem a revisão que você quer atualizar.
-
Na guia Revisões, selecione Criar revisão para abrir a página Criar revisão.
-
Em Configurações de revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.
-
Em Adicionar tags — opcional, adicione tags associadas ao recurso.
-
Escolha Criar.
A nova revisão foi criada.
-
-
Na seção Trabalhos, selecione Importar do Amazon S3.
-
Siga as instruções na janela Importar do Amazon S3 e selecione Importar ativos.
Um trabalho é iniciado para importar o ativo para o conjunto de dados. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Importando ativos de um assinado URL
Você pode usar assinado URLs para importar ativos que não estão armazenados no Amazon S3.
Tópicos
Importando ativos de um assinado URL ()AWS SDKs
Para importar ativos de um assinado URL (AWS SDKs)
-
Crie uma solicitação
CreateJob
do tipoIMPORT_ASSET_FROM_SIGNED_URL
. -
Inclua o seguinte na solicitação:
-
AssetName
-
DataSetID
-
Md5Hash
-
RevisionID
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que requer o retornoJobId
na etapa 1. -
(Opcional) Atualize a propriedade do nome dos ativos após sua criação.
-
As informações da resposta incluem o
SignedUrl
que você pode usar para importar seu arquivo.
nota
O assinado URL expira um minuto depois de ser criado.
Importação de ativos de um URL (console) assinado
Para importar um ativo de um URL (console) assinado
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados propriedade, selecione o conjunto de dados que tem o ativo que você quer atualizar.
-
Na guia Revisões, selecione Criar revisão para abrir a página Criar revisão.
-
Em Configurações de revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.
-
Em Adicionar tags — opcional, adicione tags associadas ao recurso.
-
Escolha Criar.
A nova revisão foi criada.
-
-
Na seção Trabalhos, selecione Upload.
-
Siga as instruções na janela de upload e selecione Abrir.
Um trabalho é iniciado para importar o ativo para o conjunto de dados. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Importação de ativos de um Amazon API Gateway API
AWS Data Exchange os assinantes podem usar suas IAM credenciais e AWS SDKs ligar APIs de provedores de dados. AWS Data Exchange gerencia o acesso APIs ao lidar com direitos de autenticação e assinatura.
Importação de API ativos de um Amazon API Gateway API ()AWS SDKs
nota
Atualmente, a SendApiAsset
operação não é compatível com o seguinteSDKs:
-
AWS SDK for .NET
-
AWS SDK for C++
-
AWS SDK for Java 2.x
Para importar ativos de um Amazon API Gateway API (AWS SDKs)
-
Crie uma solicitação
CreateJob
do tipoIMPORT_ASSET_FROM_API_GATEWAY_API
. -
Inclua o seguinte na solicitação:
-
ApiID
-
DataSetID
-
ProtocolType
-
RevisionID
-
Stage
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que exija o retornoJobId
na etapa 1. -
(Opcional) Pesquise a operação
GetJob
para aguardar a conclusão do trabalho. -
(Opcional) Atualize a propriedade do nome dos ativos após a criação.
Importação de API ativos de um Amazon API Gateway API (console)
Para importar um ativo de um Amazon API Gateway API (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados propriedade, selecione o conjunto de dados que tem o ativo que você quer atualizar.
-
Na guia Revisões, selecione Criar revisão para abrir a página Criar revisão.
-
Em Configurações de revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.
-
Em Adicionar tags — opcional, adicione tags associadas ao recurso.
-
Escolha Criar.
A nova revisão foi criada.
-
-
Para a seção de APIativos, escolha Adicionar API estágio.
-
Na página Adicionar API estágio, selecione o Amazon API Gateway API e o nome do estágio da sua conta Conta da AWS ou de outra conta.
-
Para documentos API para assinantes:
-
Atualize o APInome para um nome claro e conciso que os assinantes possam entender.
-
Documente a especificação Open API 3.0 inserindo a especificação no campo e importando a especificação escolhendo Importar de. JSONarquivo ou importando a especificação escolhendo Importar do Amazon API Gateway.
-
-
Escolha Adicionar API estágio.
Um trabalho é iniciado para importar seus API ativos para seu conjunto de dados. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Importação de ativos de um compartilhamento de AWS Data Exchange dados para o Amazon Redshift
Ao importar ativos usando o compartilhamento de AWS Data Exchange dados para o Amazon Redshift, você pode começar a consultar, analisar e operacionalizar tabelas de terceiros do Amazon Redshift após a assinatura.
Importação de ativos de um compartilhamento de AWS Data Exchange dados para o Amazon Redshift ()AWS SDKs
Para importar ativos de um compartilhamento de AWS Data Exchange dados para o Amazon Redshift ()AWS SDKs
-
Crie uma solicitação
CreateJob
do tipoIMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES
. -
Inclua o seguinte na solicitação:
-
AssetSources
-
DataShareArn
-
-
DataSetID
-
RevisionID
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que exija o retornoJobId
na etapa 1. -
(Opcional) Pesquise a operação
GetJob
para aguardar a conclusão do trabalho. -
(Opcional) Atualize a propriedade do nome dos ativos após a criação.
Importação de ativos de um compartilhamento de AWS Data Exchange dados para o Amazon Redshift (console)
Para importar um ativo de um compartilhamento de ADE dados (para o console do Amazon Redshift)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados propriedade, selecione o conjunto de dados que tem o ativo que você quer atualizar.
-
Na guia Revisões, selecione Criar revisão para abrir a página Criar revisão.
-
Em Configurações de revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.
-
Em Adicionar tags — opcional, adicione tags associadas ao recurso.
-
Escolha Criar.
A nova revisão foi criada.
-
-
Na seção Unidade de compartilhamento de dados di AWS Data Exchange para o Amazon Redshift, selecione Adicionar unidade de compartilhamento de dados.
-
Na página Adicionar compartilhamento AWS Data Exchange de dados à revisão, selecione o compartilhamento de dados ou compartilhamentos de dados que você deseja adicionar.
-
Selecione Adicionar unidade de compartilhamento de dados.
Um trabalho é iniciado para importar os ativos para o conjunto de dados. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Importação de ativos de AWS Lake Formation (versão prévia)
Ao importar ativos de AWS Lake Formation para AWS Data Exchange, as IAM permissões que você usa devem incluir as seguintes habilidades:
-
Escrever, conceder e revogar permissões do Lake Formation
-
Criar compartilhamentos de recursos para tabelas, bancos de dados e catálogos
-
Atualizar, excluir, associar e desassociar compartilhamentos de recursos para qualquer compartilhamento de recursos começando com Lake Formation
Para obter mais informações sobre IAM as permissões necessárias e recomendadas, consulteGerenciamento de identidade e acesso em AWS Data Exchange.
Importação de ativos de AWS Lake Formation (Pré-visualização) (AWSSDKs)
Para importar ativos de AWS Lake Formation (Pré-visualização) (AWSSDKs)
-
Crie uma solicitação
CreateJob
do tipoImport_Assets_From_Lake_Formation_Tag_Policy
. -
Inclua o seguinte na solicitação:
-
AssetSources
-
CatalogId
-
Database
-
Expression
-
TagKey
-
TagValues
-
-
Permissions
-
-
Table
-
Expression
-
TagKey
-
TagValues
-
-
Permissions
-
-
-
RoleArn
-
DataSetId
-
RevisionId
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que exija oJobId
. -
(Opcional) Pesquise a operação
GetJob
para aguardar a conclusão do trabalho. -
(Opcional) Atualize a propriedade do nome dos ativos após a criação.
Importação de ativos de AWS Lake Formation (versão prévia) (console)
Para importar um ativo de AWS Lake Formation (Pré-visualização) (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados de propriedade, selecione o conjunto de dados que tem a revisão que você quer atualizar.
-
Na guia Revisões, selecione Criar revisão para abrir a página Criar revisão.
-
Em Configurações de revisão, forneça um comentário opcional para sua revisão que descreva a finalidade da revisão.
-
Em Adicionar tags — opcional, adicione tags associadas ao recurso.
-
Escolha Criar.
A nova revisão foi criada.
-
-
Para a seção de Permissão de dados do Lake Formation, selecione Adicionar tag LF.
-
Selecione a Chave e os Valores que você deseja adicionar e selecione Adicionar tag LF.
-
(Opcional) Selecione Visualizar recursos para visualizar os recursos do catálogo de dados associados aos quais você está concedendo permissão.
-
-
Em Acesso ao serviço, selecione a função para a qual importar os AWS Lake Formation recursos AWS Data Exchange.
-
Selecione a Permissão para Criar dados do Lake Formation.
Um trabalho é iniciado para importar seus ativos para seu conjunto de dados. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportar ativos
Tanto provedores quanto assinantes podem exportar ativos de uma revisão publicada do produto. Você pode exportar ativos de duas maneiras:
Exportar ativos para um bucket do S3
Quando você exporta ativos para o Amazon S3, as IAM permissões que você usa devem incluir a capacidade de ler os buckets do S3 do AWS Data Exchange serviço e gravar no bucket do S3 onde seus ativos estão armazenados. Você pode exportar para qualquer bucket do S3 ao qual tenha permissão de acesso, independentemente da propriedade. Para obter mais informações, consulte Permissões do Amazon S3.
AWS Data Exchange suporta parâmetros de criptografia configuráveis ao exportar conjuntos de dados para o Amazon S3. Nas informações do trabalho de exportação, você pode especificar a configuração de criptografia do lado do servidor do Amazon S3 que você deseja aplicar aos objetos exportados. Você pode optar por usar a criptografia do lado do servidor com as chaves gerenciadas pelo Amazon S3 (SSE-S3) ou a criptografia do lado do servidor com as chaves armazenadas em (-). AWS KMS keys AWS Key Management Service SSE KMS Para ter mais informações, consulte Como proteger dados usando criptografia do lado do servidor no Guia do usuário do Amazon Simple Storage Service.
Importante
Recomendamos levar em consideração os recursos de segurança do Amazon S3 ao exportar dados para o Amazon S3. Para obter informações sobre diretrizes gerais e melhores práticas, consulte Práticas recomendadas de segurança para Amazon S3 no Guia do usuário do Amazon Simple Storage Service.
Importante
Se o fornecedor tiver marcado um produto como contendo informações de saúde protegidas (PHI) sujeito à Lei de Portabilidade e Responsabilidade de Seguros de Saúde de 1996 (HIPAA), você não poderá exportar os conjuntos de dados do produto para o seu, a Conta da AWS menos que tal Conta da AWS seja designado como uma HIPAA conta (conforme definido no Adendo de Associado AWS Comercial encontrado em). AWS Artifact
Você pode exportar até 100 ativos em um único trabalho.
Tópicos
O vídeo a seguir explica mais sobre como exportar ativos do AWS Data Exchange.
Exportação de ativos para um bucket do S3 ()AWS SDKs
Para exportar ativos para um bucket do S3 ()AWS SDKs
-
Crie uma solicitação
CreateJob
do tipoEXPORT_ASSETS_TO_S3
. -
Inclua o seguinte na solicitação:
-
AssetDestinations
-
AssetID
-
Bucket
-
Key
-
-
DataSetID
-
Encryption
-
KmsKeyArn
-
Type
-
-
RevisionID
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que requer o retornoJobId
na etapa 1. -
(Opcional) Atualize a propriedade do nome dos ativos após sua criação.
nota
Para obter informações sobre como exportar uma revisão inteira como um único trabalho, consulte Exportar revisões.
Exportar ativos para um bucket do S3 como assinante (console)
Para exportar um ativo para um bucket do S3 como assinante (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Minhas assinaturas, selecione Dados autorizados.
-
Em Dados autorizados, selecione o produto que tem a revisão que você quer exportar.
-
Em Conjuntos de dados autorizados, selecione o conjunto de dados.
-
Na guia Revisões, escolha a revisão.
-
Na guia Ativos, marque a caixa de seleção ao lado dos ativos que você deseja exportar.
-
Selecione Exportar ações e, em seguida, selecione Exportar ativos selecionados para o Amazon S3.
-
Siga as instruções na janela Exportar para o Amazon S3 e selecione Exportar.
Um trabalho é iniciado para exportar seu ativo. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportar ativos para um bucket do S3 como provedor (console)
Para exportar um ativo para um bucket do S3 como provedor (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados de propriedade, selecione o conjunto de dados que tem o ativo que você quer exportar.
-
Acesse a guia Produtos para garantir que o conjunto de dados esteja associado a um produto publicado.
-
Selecione Revisão na guia Revisões.
-
Na seção Ativos importados, marque a caixa de seleção ao lado do nome do ativo.
-
Selecione Exportar ações e selecione Exportar ativos selecionados para o Amazon S3.
-
Siga as instruções na janela Exportar para o Amazon S3 e selecione Exportar.
Um trabalho é iniciado para exportar seu ativo. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportando ativos para um assinado URL
Você pode usar assinado URLs para exportar ativos que não estão armazenados no Amazon S3.
Tópicos
Exportando ativos para um assinado URL ()AWS SDKs
Você pode usar signed URLs para exportar ativos para destinos diferentes dos buckets do S3.
Para exportar ativos para um arquivo assinado URL (AWS SDKs)
-
Crie uma solicitação
CreateJob
do tipoEXPORT_ASSET_TO_SIGNED_URL
. -
Inclua o seguinte na solicitação:
-
AssetID
-
DataSetID
-
RevisionID
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que requer o retornoJobId
na etapa 1. -
(Opcional) Atualize a propriedade do nome dos ativos após sua criação.
-
As informações da resposta incluem o
SignedUrl
que você pode usar para importar seu arquivo.
nota
O assinado URL expira um minuto depois de ser criado.
Exportação de ativos para um URL assinante assinado (console)
Para exportar um ativo para um URL assinante assinado (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Minhas assinaturas, selecione Dados autorizados.
-
Em Dados autorizados, selecione o produto que tem a revisão que você quer exportar.
-
Em Conjuntos de dados autorizados, selecione o conjunto de dados.
-
Na guia Revisões, escolha a revisão.
-
Na guia Ativos, marque a caixa de seleção ao lado dos ativos que você deseja exportar.
-
Selecione Exportar ações e selecione Fazer download de ativos selecionados.
Um trabalho é iniciado para exportar o ativo. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportação de ativos para um provedor assinado URL como (console)
Para exportar um ativo para um provedor assinado URL como (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados de propriedade, selecione o conjunto de dados que tem o ativo que você quer exportar.
-
Acesse a guia Produtos para garantir que o conjunto de dados esteja associado a um produto publicado.
-
Na guia Revisões, escolha a revisão.
-
Na seção Ativos importados, marque a caixa de seleção ao lado do nome do ativo.
-
Selecione Exportar ações e selecione Fazer download dos ativos selecionados.
Um trabalho é iniciado para exportar o ativo. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportar revisões
Tanto os provedores quanto os assinantes podem exportar revisões de um conjunto de dados para um bucket do S3 ao qual tenham permissão de acesso.
AWS Data Exchange suporta parâmetros de criptografia configuráveis ao exportar revisões para o Amazon S3. Nas informações do trabalho de exportação, você pode especificar a configuração de criptografia do lado do servidor do Amazon S3 que você deseja aplicar aos objetos exportados. Você pode optar por usar a criptografia do lado do servidor com as chaves gerenciadas pelo Amazon S3 (SSE-S3) ou a criptografia do lado do servidor com as chaves armazenadas em (-). KMS AWS Key Management Service SSE KMS Para obter mais informações, consulte Proteção de dados usando criptografia no lado do servidor no Guia do desenvolvedor do Amazon Simple Storage Service.
Importante
Se o fornecedor tiver marcado um produto como contendo informações de saúde protegidas (PHI) sujeito à Lei de Portabilidade e Responsabilidade de Seguros de Saúde de 1996 (HIPAA), você não poderá exportar os conjuntos de dados do produto para o seu, a Conta da AWS menos que tal Conta da AWS seja designado como uma HIPAA conta (conforme definido no Adendo de Associado AWS Comercial encontrado em). AWS Artifact
Tópicos
O vídeo a seguir explica mais sobre como exportar ativos do AWS Data Exchange (a partir de 2:18).
Exportação de revisões para um bucket do S3 ()AWS SDKs
Para exportar uma revisão para um bucket do S3 ()AWS SDKs
-
Crie uma solicitação
CreateJob
do tipoEXPORT_REVISIONS_TO_S3
. -
Inclua o seguinte na solicitação:
-
DataSetId
-
Encryption
-
KmsKeyArn
-
Type
-
-
RevisionDestinations
-
Bucket
-
KeyPattern
-
RevisionId
-
-
-
Inicie a solicitação
CreateJob
com uma operaçãoStartJob
que requer o retornoJobId
na etapa 1. -
Os ativos recém-criados tem uma propriedade de nome igual à chave do objeto S3 original. A chave do objeto do Amazon S3 tem como padrão o padrão de chave
${Asset.Name}
.Você pode atualizar a propriedade do nome dos ativos após eles serem criados.
Para obter mais informações sobre padrões de chave, consulte Principais padrões ao exportar revisões.
nota
Se você estiver usando DataSet.Name
como referência dinâmica, deverá ter a IAM permissãodataexchange:GetDataSet
. Para obter mais informações, consulte AWS Data Exchange APIpermissões: referência de ações e recursos.
Exportar revisões para um bucket do S3 como provedor (console)
Para exportar uma revisão para um bucket do S3 como provedor (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Publicar dados, selecione Conjuntos de dados de propriedade.
-
Em Conjuntos de dados de propriedade, selecione o conjunto de dados que tem o ativo que você quer exportar.
-
Acesse a guia Produtos para garantir que o conjunto de dados esteja associado a um produto publicado.
-
Na guia Revisões, escolha a revisão.
-
Na seção Ativos importados, marque a caixa de seleção ao lado do nome do ativo.
-
Selecione Exportar ações e selecione Exportar ativos selecionados para o Amazon S3.
-
Siga as instruções na janela Exportar para o Amazon S3 e selecione Exportar.
Um trabalho é iniciado para exportar seu ativo. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportar revisões para um bucket do S3 como assinante (console)
Para exportar uma revisão para um bucket do S3 como assinante (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Minhas assinaturas, selecione Dados autorizados.
-
Em Dados autorizados, selecione o produto que tem a revisão que você quer exportar.
-
Em Conjuntos de dados autorizados, selecione o conjunto de dados.
-
Na guia Revisões, selecione a revisão e selecione Exportar para o Amazon S3.
-
Em Exportar revisão para o Amazon S3, selecione uma opção de destino, destino da pasta do bucket do Amazon S3, configure as opções de criptografia e selecione Exportar.
Um trabalho é iniciado para exportar a revisão. Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Exportar revisões automaticamente para um bucket do S3 como assinante
Quando o provedor publica novas revisões, você pode optar por exportar automaticamente novas revisões para seu bucket do Amazon S3. Você pode exportar novas revisões para até cinco buckets S3. Novas revisões aparecerão automaticamente nos buckets S3 que você selecionou.
Tópicos
nota
Para exportar automaticamente as revisões para um bucket do S3 de sua escolha, seu bucket do S3 deve ter uma política de bucket com permissões definidas para permitir a exportação de dados AWS Data Exchange para ele. Para obter mais informações, consulte Pré-requisitos para permissões de política de bucket do S3.
Pré-requisitos para permissões de política de bucket do S3
Antes de exportar automaticamente as revisões para um bucket do S3, você deve desativar os pagamentos do solicitante e seu bucket do S3 deve ter uma política de bucket com permissões definidas para permitir a exportação de dados AWS Data Exchange para ele. Os procedimentos a seguir fornecem informações sobre como editar sua política de bucket do S3 existente ou criar uma política de bucket do S3 com essas permissões.
Se o bucket do S3 estiver configurado para SSE KMS criptografia, o usuário que estiver configurando o trabalho de exportação automática deverá ter CreateGrant
permissão na KMS chave AWS Data Exchange
para copiar os objetos no bucket do S3.
Importante
Para verificar se os pré-requisitos para permissões de política de bucket do S3 foram atendidos, um objeto com o formato de nomenclatura _ADX-TEST-ACCOUNTID#
é adicionado ao bucket do S3 durante o processo de exportação automática.
Editar uma política de bucket do S3 existente
Se o seu bucket do S3 tiver uma política de bucket, conclua o procedimento a seguir para permitir que o AWS Data Exchange exporte dados para ele.
Para editar uma política de bucket do S3 existente
-
Acesse o bucket para exportar revisões.
-
Selecione a guia Permissões e escolha Editar na seção de política do bucket.
-
Copie a seguinte instrução e cole-a no final da lista de instruções.
{ "Effect": "Allow", "Principal": { "Service": "dataexchange.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::<BUCKET-NAME>/*", "Condition": { "StringEquals": { "aws:SourceAccount": "<AWS ID>" } } }
-
<BUCKET-NAME>
Substitua pelo nome do seu bucket do S3 e<AWS ID>
substitua pelo seu AWS ID. -
Escolha Salvar alterações.
-
Para adicionar mais buckets como destino para seus trabalhos de exportação automática, repita o procedimento, começando na Etapa 1.
Criação de política de bucket do S3
Se seu bucket do S3 não tiver uma política de bucket, conclua o procedimento a seguir para criar uma política de bucket do S3 para permitir a exportação de dados AWS Data Exchange para ele.
Para criar uma política de bucket do S3
-
Acesse o bucket para exportar revisões.
-
Selecione a guia Permissões e selecione Editar na seção de política de bucket.
-
Copie e cole a política de bucket a seguir no editor de política de bucket.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "dataexchange.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::<BUCKET-NAME>/*", "Condition": { "StringEquals": { "aws:SourceAccount": "<AWS ID>" } } } ] }
-
<BUCKET-NAME>
Substitua pelo nome do seu bucket do S3 e<AWS ID>
substitua pelo seu AWS ID. -
Escolha Salvar alterações.
-
Para adicionar mais buckets como destino para seus trabalhos de exportação automática, repita o procedimento, começando na Etapa 1.
Exportar automaticamente revisões para um bucket do S3 como assinante (console)
nota
Para exportar automaticamente as revisões para um bucket do S3 de sua escolha, seu bucket do S3 deve ter uma política de bucket com permissões definidas para permitir a exportação de dados AWS Data Exchange para ele. Para obter mais informações, consulte Pré-requisitos para permissões de política de bucket do S3.
Para exportar automaticamente uma revisão para um bucket do S3 como assinante (console)
-
Abra o navegador e faça login no console do AWS Data Exchange
. -
No painel de navegação à esquerda, em Minhas assinaturas, selecione Dados autorizados.
-
Em Dados autorizados, selecione o produto que tem a revisão que você quer exportar.
-
Em Conjuntos de dados autorizados, selecione o conjunto de dados.
-
Na guia Revisões, em Destinos de trabalho de exportação automática, escolha Ações e Adicionar destino de trabalho de exportação automática.
-
Em Adicionar destino do trabalho de exportação automática, selecione a opção destino Simples ou Avançada.
-
Se você escolher a opção Simples, selecione o destino da pasta do bucket do Amazon S3 na lista suspensa e nas opções de criptografia e, em seguida, selecione Adicionar destino do bucket.
-
Se você escolher a opção Avançada, selecione o destino da pasta de bucket do Amazon S3 na lista suspensa, selecione o Padrão de nomenclatura da chave e anexe-o ao caminho.
-
-
Revise a Saída.
-
Defina as Opções de criptografia, revise os Preços do Amazon S3 e selecione Adicionar destino do bucket.
O destino do bucket do Amazon S3 aparece na guia Revisões em Destinos de trabalho de exportação automática.
Um trabalho é iniciado para exportar automaticamente a revisão.
Para verificar se os pré-requisitos para permissões de política de bucket do S3 foram atendidos, um objeto com o formato de nomenclatura
_ADX-TEST-ACCOUNTID#
é adicionado ao bucket do S3.Após a conclusão do trabalho, o campo Estado na seção Trabalhos será atualizado para Concluído.
Para adicionar outro destino, selecione Ações e Adicionar destino do trabalho de exportação automática.
Para editar, escolha o destino que você quer editar, selecione Ações e, em seguida, Editar configuração de destino.
Para excluir, selecione Ações e, em seguida, Remover destino do trabalho de exportação automática.
Exportação automática de revisões para um bucket do S3 como assinante ()AWS SDKs
nota
Para exportar automaticamente as revisões para um bucket do S3 de sua escolha, seu bucket do S3 deve ter uma política de bucket com permissões definidas para permitir a exportação de dados AWS Data Exchange para ele. Para obter mais informações, consulte Pré-requisitos para permissões de política de bucket do S3.
Para exportar automaticamente uma revisão para um bucket do S3 ()AWS SDKs
-
Criar uma solicitação de
Create_Event_Action
. -
Inclua o seguinte na solicitação:
-
Action
-
ExportRevisionToS3
-
Encryption
-
KmsKeyArn
-
Type
-
-
-
RevisionDestination
-
Bucket
-
KeyPattern
-
-
-
Event
-
RevisionPublished
-
DataSetId
-
-
-
-
Modifique o padrão de chave, se necessário. A chave do objeto do Amazon S3 tem como padrão o padrão de chave
{Revision.CreatedAt}/{Asset.Name}
.Para obter mais informações sobre padrões de chave, consulte Principais padrões ao exportar revisões.
Para verificar se os pré-requisitos para permissões de política de bucket do S3 foram atendidos, um objeto com o formato de nomenclatura
_ADX-TEST-ACCOUNTID#
é adicionado ao bucket do S3.
Principais padrões ao exportar revisões
Ao exportar uma revisão, cada ativo se torna um objeto no bucket do S3. Os nomes dos objetos são baseados em um padrão de chave fornecido por você. É possível usar referências dinâmicas que representam atributos de ativos para criar um padrão para os nomes gerados automaticamente durante a exportação. Use as referências dinâmicas mostradas na tabela a seguir.
Referências dinâmicas | Descrição |
---|---|
${Asset.Id} |
O ID do ativo. |
${Asset.Name} |
O nome do ativo. |
${DataSet.Id} |
O ID do conjunto de dados que está sendo exportado. |
${DataSet.Name} |
O nome do conjunto de dados que está sendo exportado. |
${Revision.CreatedAt} |
A UTC data e a hora em que a revisão foi criada, no seguinte formato: YYYY -MM DDTHH -:MM:. SSZ Por exemplo: 2021-10-08T16:33:19.787Z |
${Revision.CreatedAt.Day} |
O dia do mês em que a revisão foi criada. |
${Revision.CreatedAt.Month} |
O mês em que a revisão foi criada. |
${Revision.CreatedAt.Year} |
O ano em que a revisão foi criada. |
${Revision.Id} |
O ID da revisão que está sendo exportada. |
Você pode usar essas referências dinâmicas para criar os padrões de chave para os nomes dos seus ativos. Você deve incluir pelo menos uma das duas referências dinâmicas Asset
, que são ${Asset.Name}
e ${Asset.Id}
.
Por exemplo, usar ${Revision.Id}/${Asset.Name}
como padrão de chave resulta em objetos do Amazon S3 que usam o ID de revisão e o nome do ativo (separados por uma barra) como nome do objeto.
Se você exportar uma revisão com o ID testRevisionId
que tenha dois ativos chamados asset1
e asset2
, os ativos serão exportados para os seguintes locais no Amazon S3:
-
<bucket>/testRevisionId/asset1
-
<bucket>/testRevisionId/asset2
nota
Os objetos resultantes devem ter nomes exclusivos. Se eles tiverem os mesmos nomes dos objetos existentes no bucket do S3, sua exportação substituirá os objetos existentes. Se a revisão que você está exportando tiver nomes não exclusivos (por exemplo, dois ativos com o mesmo nome), a exportação falhará. A única referência dinâmica que é única é ${Asset.Id}
.