Utilizzo dell'estensione Visual Studio Code per lo sviluppo

Oracle NoSQL Database Cloud Service offre un'estensione per Microsoft Visual Studio Code che consente di connettersi a un'istanza in esecuzione di Oracle NoSQL Database Cloud Service.

È possibile utilizzare l'estensione Codice di Oracle NoSQL Database Visual Studio (VS) per:
  • Visualizzare le tabelle in una struttura ad albero ben definita con Esplora tabelle.
  • Visualizzare informazioni su colonne, indici, chiavi primarie e chiavi partizione per una tabella.
  • Visualizzare i dati delle colonne in una struttura JSON ben formattata.
  • Creare tabelle utilizzando una voce di schema basata su form o fornire istruzioni DDL.
  • Elimina tabelle.
  • Aggiungere nuove colonne utilizzando istruzioni DDL di inserimento o fornitura basate su form.
  • Elimina colonne.
  • Crea indici.
  • Elimina indici.
  • Eseguire le query SELECT SQL su una tabella e visualizzare i risultati delle query in formato tabulare.
  • Esegue istruzioni DML per aggiornare, inserire ed eliminare dati da una tabella.
  • Scaricare il risultato della query dopo aver eseguito la query SELECT in un file JSON.
  • Scaricare ogni riga del risultato ottenuto dopo aver eseguito la query SELECT in un file JSON.

Questo articolo contiene i seguenti argomenti:

Installazione dell'estensione del codice di Oracle NoSQL Database Visual Studio

È possibile installare l'estensione VS Code di Oracle NoSQL Database in due modi. Eseguire l'installazione da Visual Studio Marketplace per l'installazione online o dal pacchetto VSIX utilizzando il file *.vsix per l'installazione offline.

Per poter installare l'estensione Visual Studio (VS) Code di Oracle NoSQL Database, è necessario installare Visual Studio Code. È possibile scaricare Visual Studio Code qui.
  1. In Visual Studio Code fare clic sull'icona Estensioni nella navigazione a sinistra.


    Barra attività codice Visual Studio

    In alternativa, è possibile aprire la vista Estensioni premendo:
    • Controllo (Windows e Linux) + Maiusc + X
    • (macOS) Comando + MAIUSC + X.
  2. Cerca Oracle NoSQL Database Connector nel marketplace delle estensioni.
  3. Fare clic su Installa nell'estensione Oracle NoSQL Database Connector
  1. Scaricare il file VSIX per Oracle NoSQL Database dal sito Download di Oracle NoSQL Database.
  2. In Visual Studio Code fare clic sull'icona Estensioni nella navigazione a sinistra.


    Barra attività codice Visual Studio

    In alternativa, è possibile aprire la vista Estensioni premendo:
    • Controllo (Windows e Linux) + Maiusc + X
    • (macOS) Comando + MAIUSC + X.
  3. Nella vista Estensioni, fare clic sul menu Altre azioni (...), quindi su Installa da VSIX....


    Installa da azione VSIX

  4. Individuare la posizione in cui è memorizzato il file *.vsix e fare clic su Installa.

Connessione a Oracle NoSQL Database Cloud Service dal codice di Visual Studio

L'estensione del codice di Oracle NoSQL Database Visual Studio (VS) fornisce due metodi per la connessione a Oracle NoSQL Database Cloud Service o Oracle NoSQL Database Cloud Simulator.

È possibile fornire un file di configurazione con le informazioni di connessione o compilare le informazioni di connessione nei campi specifici. Se si utilizza un driver Node.js e i dettagli di connessione sono già stati salvati in un file, utilizzare l'opzione Connetti tramite file di configurazione per connettersi a Oracle NoSQL Database Cloud Service. In caso contrario, se si sta creando una nuova connessione, utilizzare l'opzione Compila campi singoli.
  1. In Visual Studio Code fare clic sulla vista Oracle NoSQL DB nella barra delle attività.


    Barra attività codice Visual Studio

  2. Aprire la pagina Mostra impostazioni di connessione di Oracle NoSQL DB dalla tavolozza dei comandi o dalla vista Oracle NoSQL DB nella barra delle attività.
    • Apri dalla tavolozza dei comandi
      1. Aprire la tavolozza dei comandi premendo:
        • Controllo (Windows e Linux) + Maiusc + P
        • (macOS) Comando + MAIUSC + P
      2. Nella tavolozza dei comandi selezionare OracleNoSQL: Mostra impostazioni connessioni.

        Suggerimento

        Immettere oraclenosql nella tavolozza dei comandi per visualizzare tutti i comandi di Oracle NoSQL DB che è possibile utilizzare.


        Oracle NoSQL DB: comando Mostra impostazioni connessioni

    • Apri da vista Oracle NoSQL DB
      1. Espandere il riquadro SPIRAZIONE TABELLA nella navigazione a sinistra se è compressa.
      2. Fare clic su Aggiungi connessione per aprire la pagina Mostra impostazioni di connessione di Oracle NoSQL DB.


      EXPLORER TABELLE DI Oracle NoSQL DB

  3. Nella pagina Mostra impostazioni di connessione fare clic su Cloud o su CloudSim per connettersi a Oracle NoSQL Database Cloud Service o a Oracle NoSQL Database Cloud Simulator.


    NoSQL Impostazioni di connessione DB per Oracle NoSQL Database Cloud Service

  4. Immettere le informazioni di connessione

    Tabella - Parametri di connessione al cloud

    Campo Descrizione Valore di esempio
    Area: Selezionare l'identificativo dell'area dell'endpoint di Oracle NoSQL Database Cloud Service. us-ashburn-1
    File di configurazione: Cercare la posizione in cui è memorizzato il file di configurazione OCI. /home/user/security/config/oci.config
    Profilo: Nome del profilo di configurazione da utilizzare per connettersi a Oracle NoSQL Database Cloud Service.

    Se non si specifica questo valore, per impostazione predefinita viene utilizzato il profilo DEFAULT.

    		ADMIN_USER
    Compartimento: Il nome o l'OCID del compartimento per lo schema di Oracle NoSQL Database Cloud Service.

    Se non si fornisce alcun valore, per impostazione predefinita viene utilizzato il compartimento root.

    Puoi creare compartimenti in Oracle Cloud Infrastructure Identity and Access Management (IAM). Vedere Impostazione della tenancy e Gestione dei compartimenti nella documentazione di Oracle Cloud Infrastructure.

    • Nome compartimento

      appartamento

    • Nome del compartimento qualificato con il relativo compartimento padre

      parent.childcompartment

    • OCID compartimento

      ocid1.tenancy.oc1...<unique_ID>
    OCID tenant: OCID della tenancy per Oracle NoSQL Database Cloud Service. Vedere Where to Get the Tenancy's OCID and User's OCID nella Documentazione di Oracle Cloud Infrastructure ocid1.tenancy.oc1..<unique_ID>
    OCID utente: OCID dell'utente per Oracle NoSQL Database Cloud Service. Vedere Where to Get the Tenancy's OCID and User's OCID nella Documentazione di Oracle Cloud Infrastructure. ocid1.user.oc1..<unique_ID>
    Fingerprint: Impronta per la chiave privata aggiunta a questo utente.

    L'impronta della chiave di firma viene creata durante la generazione e il caricamento della chiave di firma API. Vedere How to Get the Key's Fingerprint nella documentazione di Oracle Cloud Infrastructure.

    		12:34:56:78:90:ab:cd:ef:12:34:56:78:90:ab:cd:ef
    File chiave privata: Individuare la posizione in cui è memorizzata la chiave privata. Vedere How to Generate a API Signing Key per generare la chiave di firma con una passphrase opzionale. /home/user/.oci/oci_api_key.pem
    Passphrase: Passphrase specificata durante la creazione della chiave privata. La passphrase della chiave di firma viene creata durante la generazione e il caricamento della chiave di firma API. Vedere How to Get the Key's Fingerprint nella documentazione di Oracle Cloud Infrastructure.

    Obbligatorio, solo se la chiave è cifrata.

    		 
    Compartimento: Il nome o l'OCID del compartimento per lo schema di Oracle NoSQL Database Cloud Service.

    Se non si fornisce alcun valore, per impostazione predefinita viene utilizzato il compartimento root.

    Puoi creare compartimenti in Oracle Cloud Infrastructure Identity and Access Management (IAM). Vedere Impostazione della tenancy e Gestione dei compartimenti nella documentazione di Oracle Cloud Infrastructure.

    • Nome compartimento

      appartamento

    • Nome del compartimento qualificato con il relativo compartimento padre

      parent.childcompartment

    • OCID compartimento

      ocid1.tenancy.oc1...<unique_ID>

    Tabella - Parametri di connessione CloudSim

    Campo Descrizione Valore di esempio
    Endpoint: URL dell'endpoint del servizio dell'istanza del simulatore di Oracle NoSQL Database Cloud. http://myinstance.cloudsim.com:8080

    Se non viene specificato, viene utilizzato per impostazione predefinita il valore http://localhost:8080.

    Identificativo tenant: Identificativo univoco per identificare il tenant. Tenant01

    Se non viene specificato, viene utilizzato per impostazione predefinita il valore TestTenant.

  5. Fare clic su Connetti.
  6. Fare clic su Reimposta per cancellare i dettagli della connessione salvata dall'area di lavoro.
  1. Creare il file di configurazione, ad esempio config.json o un file con l'oggetto JSON. Il formato del file di configurazione per la connessione a Oracle NoSQL Database Cloud Service o Oracle NoSQL Database Cloud Simulator è il seguente:

    Tabella - Modelli di configurazione

    Oracle NoSQL Database Cloud Service Simulatore per Oracle NoSQL Database Cloud
    Modello di configurazione per connettersi utilizzando il file di configurazione OCI
    {
 "region": "<region-id-of-nosql-cloud-service-endpoint>",
 "compartment": "<oci-compartment-name-or-id>",
 "auth":
  {
   "iam":
    {
     "configFile": "<path-to-OCI-config-file>", 
     "profileName": "<oci-credentials-profile-name>"
    }
  }
}
    Modello di configurazione per connettersi utilizzando le credenziali di autenticazione IAM
    {
 "region": "<region-id-of-nosql-cloud-service-endpoint>",
 "compartment": "<oci-compartment-name-or-id>",
 "auth":
  {
   "iam":
    {
     "tenantId": "<tenancy-ocid>",
     "userId": "<user-ocid>",
     "fingerprint": "<fingerprint-for-the-signing-key>",
     "privateKeyFile": "<path-to-the-private-key>",
     "passphrase": "<passphrase-of-the-signing-key>"
     }
   }
}
    		 
    {
 "endpoint": "http://myinstance.cloudsim.com:8080",
 "auth" : "Bearer<tenant-id>"
}
  2. Aprire la tavolozza dei comandi premendo:
    • Controllo (Windows e Linux) + Maiusc + X
    • (macOS) Comando + MAIUSC + X
  3. Nella tavolozza dei comandi selezionare Oracle NoSQL: Connetti tramite file di configurazione.

    Suggerimento

    Immettere oraclenosql nella tavolozza dei comandi per visualizzare tutti i comandi di Oracle NoSQL DB che è possibile utilizzare.


    Connetti tramite file di configurazione

  4. Individuare la posizione in cui è memorizzato il file *.config e fare clic su Seleziona.

Gestione delle tabelle mediante l'estensione Visual Studio Code

Dopo aver eseguito la connessione alla distribuzione utilizzando l'estensione codice Oracle NoSQL Database Visual Studio (VS), utilizzare TABLE EXPLORER disponibile nella navigazione a sinistra per:
  • Esplorare tabelle, colonne, indici, chiavi primarie e chiavi di partizione.
  • Crea nuove tabelle.
  • Elimina le tabelle esistenti.
  • Crea indici.
  • Elimina indici.
  • aggiungere colonne;
  • Elimina colonne.
  • Inserisci i dati nella tabella.
  • Esegue le query SELECT SQL.

Esplora tabelle, colonne, indici e chiavi

Quando si espande una connessione attiva, Oracle NoSQL Database VS Code mostra le tabelle in tale distribuzione.
  • Fare clic sul nome della tabella per visualizzarne le colonne, gli indici, le chiavi primarie e le chiavi partizione. Viene visualizzato il nome della colonna insieme al relativo tipo di dati.
  • È possibile aggiornare lo schema o la tabella in qualsiasi momento per eseguire nuovamente la query sulla distribuzione e popolare Oracle NoSQL Database Cloud Service con i dati più aggiornati.
    • In EXPLORER TABELLA individuare la connessione e fare clic sull'icona Aggiorna per ricaricare lo schema. In alternativa, è possibile fare clic con il pulsante destro del mouse sulla connessione e selezionare Aggiorna schema.


      Schema di aggiornamento dell'estensione del codice VS di Oracle NoSQL DB

    • In EXPLORER TABELLA individuare il nome della tabella e fare clic sull'icona Aggiorna per ricaricare la tabella. In alternativa, è possibile fare clic con il pulsante destro del mouse sul nome della tabella e selezionare Aggiorna tabella.


      Tabella di aggiornamento del codice VS di Oracle NoSQL DB

Eseguire operazioni DDL utilizzando Visual Studio Code

È possibile utilizzare Visual Studio Code per eseguire operazioni DDL.

Alcune delle operazioni DDL che possono essere eseguite dall'interno del plugin Visual Studio Code sono:

CREATE TABLE

È possibile creare la tabella Oracle NoSQL Database in due modalità:
  • Input DDL semplice: è possibile utilizzare questa modalità per creare la tabella Oracle NoSQL Database in modo dichiarativo, ovvero senza scrivere un'istruzione DDL.
  • Input DDL avanzato: è possibile utilizzare questa modalità per creare la tabella Oracle NoSQL Database utilizzando un'istruzione DDL.
  1. Passare il puntatore del mouse sulla connessione a Oracle NoSQL Database per aggiungere la nuova tabella.
  2. Fare clic sull'icona più visualizzata.
  3. Nella pagina Crea tabella selezionare Input DDL semplice.


    Creare una tabella di Oracle NoSQL Database mediante la modalità di input DDL semplice

    Tabella - Creare una tabella Oracle NoSQL Database

    Campo Descrizione
    Nome tabella: Specificare un nome di tabella univoco.
    Nome della colonna Specificare un nome di colonna per la chiave primaria nella tabella.
    Tipo di colonna Selezionare il tipo di dati per la colonna chiave primaria.
    Imposta come chiave di partizione Selezionare questa opzione per impostare questa colonna chiave primaria come chiave partizione. La chiave di partizionamento orizzontale consiste nel distribuire i dati nel cluster Oracle NoSQL Database per aumentare l'efficienza e nel posizionare i record che condividono la chiave di partizionamento orizzontale in locale per facilitarne il riferimento e l'accesso. I record che condividono la chiave partizione vengono memorizzati nella stessa posizione fisica ed è possibile accedervi in modo atomico ed efficiente.
    Rimuovi Fare clic su questo pulsante per eliminare una colonna esistente.
    + Aggiungi colonna chiave primaria Fare clic su questo pulsante per aggiungere altre colonne durante la creazione di una chiave primaria composta (a più colonne).
    Nome della colonna Specifica il nome della colonna.
    Tipo di colonna Selezionare il tipo di dati per la colonna.
    Valore predefinito (Facoltativo) Specificare un valore predefinito per la colonna.

    Nota

    Impossibile specificare i valori predefiniti per le colonne di tipo dati binario e JSON.
    Non nullo Selezionare questa opzione per specificare che una colonna deve avere sempre un valore.
    Rimuovi Fare clic su questo pulsante per eliminare una colonna esistente.
    + Aggiungi colonna Fare clic su questo pulsante per aggiungere altre colonne.
    Unità Selezionare l'unità (Giorni o Ore) da utilizzare per il valore TTL per le righe nella tabella.
    Valore Specificare la durata della scadenza per le righe nella tabella. Dopo il numero di giorni o ore, le righe scadono automaticamente e non sono più disponibili. Il valore predefinito è zero, a indicare l'ora di scadenza.

    Nota

    L'aggiornamento di TTL (Table Time to Live) non modifica il valore TTL di alcun dato esistente nella tabella. Il nuovo valore TTL viene applicato solo alle righe aggiunte alla tabella dopo la modifica di questo valore e alle righe per le quali non è stato fornito alcun valore specifico di riga di override.
  4. Fare clic su Mostra DDL per visualizzare l'istruzione DDL formata in base ai valori immessi nei campi in modalità Input DDL semplice. Questa istruzione DDL viene eseguita quando si fa clic su Crea.
  5. Fare clic su Crea.

DROP TABLE;

  1. Fare clic con il pulsante destro del mouse sulla tabella di destinazione.
  2. Fare clic su Elimina tabella.
  3. Fare clic su Sì per eliminare la tabella.

CREATE INDEX;

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Fare clic con il pulsante destro del mouse sulla tabella in cui deve essere creato l'indice. Scegliere Crea indice.
  • Specificare il nome dell'indice e le colonne da inserire nell'indice.
  • Fare clic su Aggiungi indice.

DROP INDEX;

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Fare clic sulla tabella in cui deve essere rimosso l'indice. La lista di indici viene visualizzata sotto i nomi di colonna.
  • Fare clic con il pulsante destro del mouse sull'indice da eliminare. Fare clic su Elimina indice.
  • Viene visualizzata una finestra di conferma. Fare clic su Ok per confermare l'azione di rilascio.

AGGIUNGI COLONNA

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Fare clic con il pulsante destro del mouse sulla tabella in cui deve essere aggiunta la colonna. Fare clic su Aggiungi colonne.
  • Specificare il nome della colonna e definire la colonna con le relative proprietà: tipo di dati, valore predefinito e se è annullabile.
  • Fare clic su Aggiungi nuove colonne.

ELIMINA COLONNA

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Espandere la tabella in cui è necessario rimuovere la colonna.
  • Fare clic con il pulsante destro del mouse sulla colonna da rimuovere e scegliere Elimina colonna.
  • Viene visualizzata una finestra di conferma. Fare clic su Ok per confermare l'azione di rilascio.

Eseguire operazioni DML utilizzando Visual Studio Code

È possibile aggiungere dati, modificare dati esistenti ed eseguire query sui dati dalle tabelle usingVisual Plugin Codice Studio.

Inserisci dati

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Fare clic con il pulsante destro del mouse sulla tabella in cui è necessario inserire una riga. Scegliere Inserisci riga.
  • Nel pannello Inserisci riga, immettere i dettagli per l'inserimento di una nuova riga. È possibile inserire una nuova riga in due modalità:
    • Input semplice: è possibile utilizzare questa modalità per inserire la nuova riga senza scrivere un'istruzione DML. Qui viene caricata una voce di campi riga basata su form, in cui è possibile immettere il valore di ogni campo della riga.
    • Input JSON avanzato: è possibile utilizzare questa modalità per inserire una nuova riga nella tabella fornendo un oggetto JSON contenente il nome della colonna e il valore corrispondente come coppie chiave-valore.
  • Fare clic su Inserisci riga.

Modifica dati - UPDATE ROW/DELETE ROW:

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Fare clic sulla tabella in cui è necessario modificare i dati.
  • Nella casella di testo a destra in SQL>, immettere l'istruzione SQL per recuperare i dati dalla tabella. Fare clic su > per eseguire la query.
  • Per visualizzare separatamente i dati delle singole celle, fare clic sulla cella della tabella.
  • Per eseguire operazioni DML quali Aggiorna ed Elimina riga, fare clic con il pulsante destro del mouse sulla riga specifica. Selezionare l'opzione dal menu contestuale visualizzato.
    • Elimina riga: viene visualizzata una finestra di conferma. Fare clic su OK per eliminare la riga.
    • Aggiorna riga: sotto le righe elencate viene aperto un pannello HTML separato contenente i nomi delle colonne e il relativo valore corrispondente in una voce basata su form oppure fornire l'input come oggetto coppia di chiavi ON. È possibile scegliere uno dei due metodi e fornire nuovi valori.

      Nota

      In qualsiasi riga, le colonne PRIMARY KEY e GENERATED ALWAYS AS IDENTITY non possono essere aggiornate.

Esecuzione di query SQL per una tabella

  • Individuare Table Explorer e fare clic su Aggiorna schema per ricaricare lo schema.
  • Fare clic con il pulsante destro del mouse sulla tabella e scegliere Sfoglia tabella.
  • Nella casella di testo a destra in SQL>, immettere l'istruzione SELECT per recuperare i dati dalla tabella.
  • Fare clic su > per eseguire la query. I dati corrispondenti vengono recuperati dalla tabella.
  • Fare clic con il pulsante destro del mouse su qualsiasi riga e fare clic su Scarica riga nel file JSON. La riga singola viene scaricata in un file JSON.
  • Fare clic su Scarica risultato query per salvare il risultato completo dell'istruzione SELECT come file JSON.
  • Fare clic su Recupera tutti i record per recuperare tutti i dati dalla tabella.

Rimozione di una connessione

Oracle NoSQL Database Connector fornisce due metodi per rimuovere una connessione dal codice di Visual Studio (VS).

È possibile effettuare le operazioni indicate di seguito.
  • Rimuovere una connessione con la tavolozza dei comandi oppure
  • Rimuovere una connessione dalla vista Oracle NoSQL DB nella barra delle attività.

Nota

La rimozione di una connessione da Visual Studio Code comporta l'eliminazione dei dettagli di connessione persistenti dall'area di lavoro corrente.
  1. Espandere il riquadro SPIRAZIONE TABELLA nella navigazione a sinistra se è compressa.
  2. Fare clic con il pulsante destro del mouse sulla connessione che si desidera rimuovere, quindi fare clic su Rimuovi connessione.


Explorer tabella

  1. Aprire la tavolozza dei comandi premendo:
    • Controllo (Windows e Linux) + Maiusc + P
    • (macOS) Comando + MAIUSC + P
  2. Nella tavolozza dei comandi selezionare OracleNoSQL: Rimuovi connessione.

    Suggerimento

    Immettere oraclenosql nella tavolozza dei comandi per visualizzare tutti i comandi di Oracle NoSQL DB che è possibile utilizzare.


    Rimuovere la connessione