Módulo google.appengine.ext.bulkload.bulkload_deprecated

Resumo

Gerenciador OBSOLETO para o carregamento em massa de dados para um aplicativo.

Use o novo bulkloader.

Índice

class google.appengine.ext.bulkload.bulkload_deprecated.BulkLoadsource

Bases: google.appengine.ext.webapp._webapp25.RequestHandler

Um gerenciador para solicitações de carregamento em massa.

Esta classe contém gerenciadores para o processo de carregamento em massa. Um para fornecimento de informações sobre o cookie via GET para o script do upload e outro para a atualização das entidades via solicitação POST.

Na solicitação POST, o corpo contém os dados que representam os valores das propriedades das entidades. O formato original era uma sequência de linhas de valores separados por vírgula gerenciada pelo método Load. O formato atual (versão 1), é um formato binário descrito na seção Ferramentas e Bibliotecas da documentação e é gerenciado pelo método LoadV1.

InfoPage(uri)source

Processamento de uma página de informações com o ponto de extremidade do POST e o sinalizador de cookie.

Parâmetros

uri – um string que contém a solicitação URI

Retorna

Um string com o conteúdo da página de informações a ser exibida

IterRows(reader)source

Fornecimento de uma tupla de número de linha para cada linha dos dados do CSV.

Parâmetros

reader – um leitor de CSV para os dados de entrada.

Load(kind, data)source

Análise de dados CSV, uso de um carregador para a conversão em entidades e armazenamento dos dados convertidos.

Em caso de erro, a falha ocorre rapidamente. Um código de resposta HTTP de “solicitação inválida” é retornado, e o traceback é incluído na saída.

Parâmetros

• kind – string que contém o tipo de entidade gerenciada pelo carregador

• data – string que contém os dados CSV a serem carregados

Retorna

código de resposta: código de resposta HTTP inteiro a ser retornado. Saída: string que contém o corpo da resposta HTTP

Tipo de retorno

tupla (código de resposta, saída) em que

LoadEntities(iter, loader, key_format=None)source

Geração de entidades e carregamento delas para o armazenamento de dados. Uma tupla de código HTTP e resposta do string é retornada.

Parâmetros

• iter – um iterador para a produção de pares com número de linha e conteúdo de linha.

• key_format – um string de formato para a conversão de um número de linha em um código da entidade. Se None, os códigos de entidade são gerados automaticamente.

get()Fonte

Gerencia um GET. Basta mostrar uma página de informações.

post()Fonte

Gerenciamento de POST. Leitura de dados CSV, conversão em entidades e armazenamento dos dados convertidos.

class google.appengine.ext.bulkload.bulkload_deprecated.Loader(kind, properties)source

Bases: object

Uma classe base para a criação de entidades do armazenamento de dados a partir de dados de entrada.

Para adicionar um gerenciador para o carregamento em massa de um novo tipo de entidade em seu armazenamento de dados, grave uma subclasse dessa classe para chamar o Loader .__ init__ do __init__ da sua classe.

Se você precisar executar um código extra para converter as entidades dos dados de entrada, criar propriedades ou modificar as entidades antes de inseri-las, substitua o HandleEntity.

Para a criação de entidades a partir dos dados de entrada (analisados), veja o método CreateEntity.

CreateEntity(values, key_name=None)source

Criação de uma entidade a partir de uma lista de valores de propriedade.

Parâmetros

• values – lista/tupla de str

• key_name – se especificado, o nome da entidade resultante (única)

Retorna

lista de datastore.Entity

As entidades retornadas são preenchidas com os valores de propriedade do argumento, convertidas em tipos nativos com o mapa de propriedades do construtor e transmitidas pelo HandleEntity. Elas estarão prontas para serem inseridas.

Gera

AssertionError se o número de valores não corresponder ao número de propriedades no mapa.

HandleEntity(entity)source

Pode ser substituído pelas subclasses para a adição de um código de conversão de entidade personalizado.

Chamado para cada entidade, depois que as propriedades são preenchidas a partir do CSV, mas antes de serem armazenadas. Pode ser substituído pelas subclasses para a adição de código de gerenciamento de entidades personalizado.

A entidade a ser inserida será retornada. Se for preciso inserir várias entidades, uma lista de entidades é retornada. Se não for preciso inserir uma entidade, None ou [] é retornado.

Parâmetros

entidade: datastore.Entity

Retorna

datastore.Entity ou lista de datastore.Entity

static RegisteredLoaders()source

Uma lista das instâncias do carregador que foram criadas é retornada.

kind()source

O tipo de entidade gerenciada por este carregador é retornada.

google.appengine.ext.bulkload.bulkload_deprecated.Validate(value, type)source

Verificação de que o valor não é vazio e é do tipo correto.

ValueError é gerado se o valor for None ou vazio, TypeError se não for do tipo informado.

Parâmetros

• value – qualquer valor

• type – um tipo ou uma tupla de tipos

google.appengine.ext.bulkload.bulkload_deprecated.main(*loaders)source

Inicialização do upload em massa.

TypeError é gerado se não for dada pelo menos uma instância do carregador.

Parâmetros

loaders – uma ou mais instâncias do carregador.