Archiviazione e recupero dei dati

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata al momento della creazione dell'app. Il codice non corrispondono a un paese o a una provincia, anche se potrebbero essere visualizzati alcuni ID regione in modo simile ai codici paese e provincia di uso comune. Per le app create dopo il giorno Febbraio 2020, REGION_ID.r è incluso in URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Aggiorna il servizio web per connetterti ai dati e gestirli tramite Firestore in modalità Datastore (Datastore). Utilizza il client Datastore biblioteche per connettere il tuo servizio web a Datastore, un sistema non relazionale (NoSQL) database creato per scalabilità automatica, prestazioni elevate e facilità di applicazione sviluppo del prodotto.

In questo passaggio, aggiorni il servizio web in modo che memorizzi i dati delle richieste di pagine in Datastore e mostra un elenco delle ultime dieci richieste di pagina. L'obiettivo è far funzionare lo spazio di archiviazione dei dati per il tuo servizio web prima di aggiungere Firebase Authentication e personalizzare l'archiviazione dei dati di utenti autenticati.

Prima di iniziare

Se hai completato tutti i passaggi precedenti della guida, salta questa sezione. In caso contrario, completa una delle seguenti operazioni:

  • Inizia dalla sezione Creazione di un'app Python 3 e completare tutti i passaggi per arrivare a questo.

  • Se disponi già di un progetto Google Cloud, puoi continuare scaricando una copia del servizio web:

    1. Scarica il repository delle applicazioni di esempio utilizzando Git:

      git clone https://github.com/GoogleCloudPlatform/python-docs-samples

      In alternativa, puoi scaricare l'anteprima come file ZIP ed estrarlo.

    2. Vai alla directory che contiene una copia dei file dal passaggio precedente:

      cd python-docs-samples/appengine/standard_python3/building-an-app/building-an-app-1

Archiviazione e recupero di entità Datastore

Archivia e recupera le tempistiche delle richieste dei siti come entità Datastore completando i seguenti passaggi:

  1. Aggiungi il seguente codice al file main.py:

    from google.cloud import datastore

datastore_client = datastore.Client()

def store_time(dt):
    entity = datastore.Entity(key=datastore_client.key("visit"))
    entity.update({"timestamp": dt})

    datastore_client.put(entity)


def fetch_times(limit):
    query = datastore_client.query(kind="visit")
    query.order = ["-timestamp"]

    times = query.fetch(limit=limit)

    return times

    Il metodo store_time riportato sopra utilizza le librerie client di Datastore per creare una nuova entità in Datastore. Datastore le entità sono oggetti dati costituiti da chiavi e proprietà. In questo nel caso in cui la chiave dell'entità sia il suo kind personalizzato, visit. L'entità ha inoltre una proprietà, timestamp, contenente l'ora di una richiesta di pagina.

    Il metodo fetch_times usa la chiave visit per eseguire query il database per le dieci entità visit più recenti e quindi archivia queste entità in un elenco in ordine decrescente.

  2. Aggiorna il metodo root per chiamare i nuovi metodi:

    @app.route("/")
def root():
    # Store the current access time in Datastore.
    store_time(datetime.datetime.now(tz=datetime.timezone.utc))

    # Fetch the most recent 10 access times from Datastore.
    times = fetch_times(10)

    return render_template("index.html", times=times)

  3. Aggiorna il file templates/index.html per stampare timestamp di ciascuna entità:

    <h2>Last 10 visits</h2>
{% for time in times %}
  <p>{{ time['timestamp'] }}</p>
{% endfor %}

  4. Assicurati che il file requirements.txt includa tutte le dipendenze necessarie:

    Flask==3.0.0
google-cloud-datastore==2.15.1

Per ulteriori informazioni su entità, proprietà e chiavi Datastore, consulta Entità, proprietà e chiavi. Per ulteriori informazioni sull'utilizzo delle librerie client di Datastore, consulta Librerie client di Datastore.

Test del servizio web

Testa il tuo servizio web eseguendolo localmente in un ambiente virtuale:

  1. Esegui questi comandi principale del progetto per installare nuove dipendenze ed eseguire del tuo servizio web. Se non hai configurato un ambiente virtuale per i test locali, consulta per testare il tuo servizio web.

    pip install -r requirements.txt
python main.py

  2. Inserisci il seguente indirizzo nel browser web per visualizzare il servizio web:

    http://localhost:8080

Puoi visualizzare le entità create dal tuo servizio web nella Console Google Cloud:

Vai alla pagina Entità Datastore

Deployment del servizio web

Ora che Datastore funziona in locale, puoi rieseguire il deployment in App Engine.

Esegui questo comando dalla directory principale del progetto: posizione in cui si trova il file app.yaml:

gcloud app deploy

Tutto il traffico viene instradato automaticamente alla nuova versione di cui hai eseguito il deployment.

Per ulteriori informazioni sulla gestione delle versioni, consulta la sezione Gestione dei servizi e delle versioni.

Visualizzazione del servizio

Per avviare rapidamente il browser e accedere al tuo servizio web all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com, esegui questo comando:

gcloud app browse

Passaggi successivi

Ora che Datastore funziona con il tuo servizio web, è tutto pronto per scoprire come aggiungere Firebase al tuo servizio web.

Indietro
Deployment del servizio web
Avanti
Aggiungi Firebase