Erste Schritte mit Oracle NoSQL Database Cloud Service

Oracle NoSQL Database Cloud Service ist ein vollständig verwalteter Datenbank-Cloud-Service, der für Datenbankvorgänge konzipiert ist, die vorhersehbare Antworten mit einer Latenz von einem Millisekunden auf einfache Abfragen erfordern.

Mit NoSQL Database Cloud Service können Entwickler sich ganz auf die Anwendungsentwicklung konzentrieren, anstatt Clusterserver einzurichten oder Systemüberwachung, -optimierung, -diagnose und -skalierung auszuführen. NoSQL Database Cloud Service ist geeignet für Anwendungen wie Internet der Dinge (Internet of Things), Personalisierung der Benutzererfahrung, sofortige Betrugserkennung und Onlineanzeige von Werbung.

Nach der Authentifizierung mit Ihrem Oracle Cloud-Account können Sie eine NoSQL-Tabelle erstellen und Durchsatz- und Speicheranforderungen für die Tabelle angeben. Oracle reserviert und verwaltet die Ressourcen, um Ihre Anforderungen zu erfüllen, und stellt für Sie Kapazität bereit. Die Kapazität wird mit Lese- und Schreibeinheiten für den Durchsatz und GB für Speichereinheiten angegeben.

Dieser Artikel enthält die folgenden Themen:

Verwandte Themen

Quicklinks

Sie können mit Oracle NoSQL Database Service über einen der folgenden Quicklinks beginnen:

Tabelle - Quicklinks

     

Erste Schritte

Verbinden

IDE und SDKs

Create Tables

Daten einfügen und untersuchen

Manage Tables

Sicherheit verwalten

Service überwachen

Dienstprogramme

SQL-Referenz

Referenzdokumentationen

Service einrichten

Wenn Sie Oracle NoSQL Database Cloud Service zum ersten Mal einrichten, befolgen Sie diese Aufgaben als Richtlinie.

Aufgabe Referenz Zugehörige Informationen
Geben Sie eine Bestellung für Oracle NoSQL Database Cloud Service auf, oder registrieren Sie sich für die kostenlose Oracle-Testversion. Für Oracle Cloud Infrastructure registrieren in der Oracle Cloud Infrastructure-Dokumentation.

Wie Sie die monatlichen Kosten Ihres Oracle NoSQL Database Cloud Service-Abonnements schätzen, erfahren Sie unter Monatliche Kosten schätzen.

Informationen zum Upgrade Ihres kostenlosen Accounts oder zum Ändern Ihrer Zahlungsart finden Sie unter Zahlungsart ändern in der Oracle Cloud Infrastructure-Dokumentation.

Oracle Cloud-Account aktivieren und zum ersten Mal anmelden. In der Konsole anmelden in der Oracle Cloud Infrastructure-Dokumentation.

Informationen zur Oracle Cloud Infrastruktorkonsole finden Sie unter Konsole verwenden in der Oracle Cloud Infrastructure-Dokumentation.

(Empfohlen) Compartment für Ihren Service erstellen. Compartment erstellen

Informationen zu Compartments finden Sie unter Compartments in der Oracle Cloud Infrastructure-Dokumentation.

Sicherheit für Ihren Service verwalten. Oracle NoSQL Database Cloud Service-Sicherheitsmodell Machen Sie sich mit dem Sicherheitsmodell von NoSQL Database Cloud Service vertraut. Informationen hierzu finden Sie unter Informationen zum Oracle NoSQL Database Cloud Service-Sicherheitsmodell.

Über die Infrastrukturkonsole auf den Service zugreifen

Erfahren Sie, wie Sie über die Infrastrukturkonsole auf Oracle NoSQL Database Cloud Service zugreifen können.

  1. Suchen Sie die Service-URL in der Willkommens-E-Mail, und melden Sie sich dann in Oracle NoSQL Database Cloud Service an.
  2. Klicken Sie im Navigationsmenü auf Datenbanken, und klicken Sie dann auf NoSQL Datenbank.
  3. Wählen Sie das Compartment aus, das vom Serviceadministrator für Ihre Tabellen erstellt wurde.
Um die Hilfe für die aktuelle Seite anzuzeigen, klicken Sie oben auf der Seite auf das Hilfesymbol Hilfe-Slide-in-Menüsymbol.

Compartment erstellen

Wenn Sie sich für Oracle Cloud Infrastructure registrieren, erstellt Oracle Ihren Mandanten mit einem Root-Compartment, das all Ihre Cloud-Ressourcen enthält. Danach erstellen Sie zusätzliche Compartments innerhalb des Mandanten (Root-Compartments) und entsprechende Policys, um den Zugriff auf die Ressourcen in jedem Compartment zu kontrollieren. Bevor Sie eine Oracle NoSQL Database Cloud Service-Tabelle erstellen, empfiehlt Oracle, dass Sie das Compartment einrichten, zu dem die Tabelle gehören soll.

Sie erstellen Compartments in Oracle Cloud Infrastructure Identity and Access Management (IAM). Siehe Mandanten einrichten und Compartments verwalten in der Oracle Cloud Infrastructure-Dokumentation.

Authentifizierung für die Verbindung zu Oracle NoSQL Database

Sie benötigen einen Oracle Cloud-Account, um Ihre Anwendung mit Oracle NoSQL Database Cloud Service zu verbinden.

Wenn Sie noch keinen Oracle Cloud-Account besitzen, können Sie mit Oracle Cloud beginnen. Sie müssen sich selbst authentifizieren, wenn Sie eine Verbindung zu Oracle NoSQL Database herstellen. Sie können auf eine der folgenden Arten authentifiziert werden:

Authentifizierungsmethode Nr. 1: Benutzer-Principals

Hier verwenden Sie einen OCI-Benutzer und einen API-Schlüssel für die Authentifizierung. Die Zugangsdaten, die für die Verbindung Ihrer Anwendung verwendet werden, sind mit einem bestimmten Benutzer verknüpft. Wenn Sie einen Benutzer für Ihre Anwendung erstellen möchten, lesen Sie Benutzer, Gruppen und Policys mit Identity and Access Management einrichten.

Sie können Ihre Zugangsdaten für diese Authentifizierungsmethode auf eine der folgenden Arten angeben:
  • Mit einer Datei auf einem lokalen Datenträger enthält die Datei Details wie Benutzer-OCID, Mandanten-OCID, Region, Private-Key-Pfad und Fingerprint. Sie können dies verwenden, wenn Sie über ein sicheres Netzwerk arbeiten und Private Keys und Konfigurationen lokal in Übereinstimmung mit Ihren Sicherheits-Policys speichern.
  • Zugangsdaten über eine API angeben.
  • Die Zugangsdaten werden irgendwo in einem Vault gespeichert.

In den Zugangsdaten enthaltene Informationen:

Tabelle - Zugangsdaten

Was ist das? Wo finde ich es?
Mandanten-ID und Benutzer-ID (beide sind OCID) Siehe Hier erhalten Sie die OCID des Mandanten und Benutzers in der Oracle Cloud Infrastructure-Dokumentation.
API-Signaturschlüssel

Für den Anwendungsbenutzer muss ein API-Signaturschlüssel generiert und hochgeladen werden. Wenn dieser Schritt bereits ausgeführt wurde, können Sie ihn überspringen.

Weitere Informationen finden Sie in den folgenden Ressourcen in der Oracle Cloud Infrastructure-Dokumentation:
Fingerprint für den Signaturschlüssel und die (optionale) Passphrase für den Signaturschlüssel Der Fingerprint und die Passphrase des Signaturschlüssels werden bei der Generierung und beim Upload des API-Signaturschlüssels erstellt. Siehe So rufen Sie den Fingerprint des Schlüssels ab in der Oracle Cloud Infrastructure-Dokumentation.

Tipp:

Notieren Sie sich den Speicherort Ihres Private Keys, der optionalen Passphrase und des Fingerprint des Public Keys beim Generieren und Hochladen des API-Signaturschlüssels.

Nachdem Sie die oben beschriebenen Aufgaben ausgeführt haben, erfassen Sie die Zugangsdaten, und geben Sie sie für Ihre Anwendung an.

Zugangsdaten für Ihre Anwendung angeben:

Mit den Oracle NoSQL Database-SDKs können Sie die Zugangsdaten für eine Anwendung auf mehrere Arten angeben. Die SDKs unterstützen eine Konfigurationsdatei sowie eine oder mehrere Schnittstellen, die eine direkte Spezifikation der Informationen ermöglichen. In der Dokumentation für den verwendeten Programmiersprachentreiber finden Sie Informationen zu den spezifischen Zugangsdatenschnittstellen.

Wenn Sie eine Konfigurationsdatei verwenden, lautet der Standardverzeichnis ~/.oci/config. Mit den SDKs kann die Datei an alternativen Speicherorten gespeichert werden. Der Inhalt sieht wie folgt aus:
[DEFAULT]
user=ocid1.user.oc1..aaaaaaaas...7ap
fingerprint=d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:13
key_file=~/.oci/oci_api_key_private.pem
tenancy=ocid1.tenancy.oc1..aaaaaaaap...keq
pass_phrase=mysecretphrase
Die Zeile [DEFAULT] gibt an, dass die nachfolgenden Zeilen das Profil DEFAULT spezifizieren. Eine Konfigurationsdatei kann mehrere Profile mit dem Präfix [PROFILE_NAME] enthalten. Beispiel:
[DEFAULT]
user=ocid1.user.oc1..aaaaaaaas...7us
fingerprint=d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:15
key_file=~/.oci/oci_api_key_private.pem
tenancy=ocid1.tenancy.oc1..aaaaabbap...keq
pass_phrase=mysecretphrase

[MYPROFILE]
user=ocid1.user.oc1..aaaaaaaas...7ap
fingerprint=d1:b2:32:53:d3:5f:cf:68:2d:6f:8b:5f:77:8f:07:13
key_file=~/.oci/oci_api_key_private.pem
tenancy=ocid1.tenancy.oc1..aaaaaaaap...keq
pass_phrase=mysecretphrase

Authentifizierungsmethode Nr. 2: Instanz-Principals

Instanz-Principals ist eine Funktion in Oracle Cloud Infrastructure Identity and Access Management (IAM), mit der Sie Serviceaufrufe von einer Instanz ausführen können. Bei Instanz-Principals müssen Sie keine Benutzerzugangsdaten für die Services konfigurieren, die auf Ihren Compute-Instanzen ausgeführt werden, oder die Zugangsdaten rotieren. Instanzen selbst sind jetzt ein Principal-Typ in IAM. Jede Compute-Instanz hat eine eigene Identität und authentifiziert sich mit Zertifikaten, die der Instanz hinzugefügt werden. Diese Zertifikate werden automatisch erstellt, Instanzen zugewiesen und rotiert.

Mit der Authentifizierung von Instanz-Principals können Sie eine Instanz dazu autorisieren, API-Aufrufe für Oracle Cloud Infrastructure-Services auszuführen. Wenn die erforderlichen Ressourcen und Policys eingerichtet wurden, kann eine Anwendung, die auf einer Instanz ausgeführt wird, öffentliche Oracle Cloud Infrastructure-Services aufrufen. Sie müssen dazu keine Benutzerzugangsdaten oder Konfigurationsdateien konfigurieren. Die Instance Principal-Authentifizierung kann von einer Instanz aus verwendet werden, in der Sie keine Konfigurationsdatei speichern möchten.

Authentifizierungsmethode Nr. 3: Resource Principals

Sie können einen Ressourcen-Principal zur Authentifizierung und zum Zugriff auf Oracle Cloud Infrastructure-Ressourcen verwenden. Der Resource Principal enthält ein temporäres Sessiontoken und sichere Zugangsdaten, mit denen sich andere Oracle Cloud-Services bei Oracle NoSQL Database authentifizieren können. Die Resource Principal-Authentifizierung ähnelt der Instance Principal-Authentifizierung, ist jedoch für Ressourcen bestimmt, die keine Instanzen sind, wie serverlose Funktionen.

Mit einem Ressourcen-Principal können Ressourcen autorisiert werden, Aktionen in Oracle Cloud Infrastructure-Services auszuführen. Jede Ressource hat eine eigene Identität, und die Ressource authentifiziert sich mit Zertifikaten, die ihr hinzugefügt werden. Diese Zertifikate werden automatisch erstellt, den Ressourcen zugewiesen und rotiert, sodass Sie keine eigenen Zugangsdaten erstellen und verwalten müssen, um auf die Ressource zuzugreifen. Wenn Sie sich mit einem Resource Principal authentifizieren, müssen Sie keine Zugangsdaten erstellen und verwalten, um auf Oracle Cloud Infrastructure-Ressourcen zuzugreifen.

Nach der Authentifizierung müssen Sie autorisiert sein, auf die Oracle Cloud Infrastructure-Ressourcen zuzugreifen. Weitere Informationen finden Sie unter Benutzer, Gruppen und Policys mit Identity and Access Management einrichten.

Anwendung mit NDCS verbinden

Erfahren Sie, wie Sie Ihre Anwendung mit Oracle NoSQL Database Cloud Service verbinden.

Ihre Anwendung stellt eine Verbindung zu Oracle NoSQL Database Cloud Service her, nachdem sie mit einer der vielen verfügbaren Methoden authentifiziert wurde.

Sie können sich mit einer der folgenden Methoden authentifizieren:
  • API-Signaturschlüssel
    • Von einem beliebigen SDK-Programm (Java, Python, C#, GO, Node.js) direkt hartcodiert
    • Eine Konfigurationsdatei mit einem Standardprofil
    • Eine Konfigurationsdatei mit einem nicht standardmäßigen Profil
  • Instanz-Principals mit Authentifizierungstoken
  • Resource Principals

Weitere Informationen zu den Authentifizierungsoptionen finden Sie unter Authentifizierung für die Verbindung mit Oracle NoSQL Database.

Mit einer der folgenden Methoden können Sie eine Verbindung zu NDCS herstellen:

  • Direkte Bereitstellung von Zugangsdaten im Code:
    /* Use the SignatureProvider to supply your credentials to NoSQL Database.
 * By default, the SignatureProvider will read your OCI configuration file 
 * from the default location, ~/.oci/config. See SignatureProvider for 
 * additional options for reading configurations in other ways.*/
SignatureProvider sp = new SignatureProvider(
 tenantId,     // a string, OCID
 userId,       // a string, OCID
 fingerprint , // a string
 privateKey,   // a string, content of private key
 passPhrase    // optional, char[]
);
//Create an handle to access the cloud service in your service region.
NoSQLHandleConfig config = new NoSQLHandleConfig(Region.<your-service-region>);
config.setAuthorizationProvider(sp);
NoSQLHandle handle = NoSQLHandleFactory.createNoSQLHandle(config);

//At this point, your handle is set up to perform data operations.
  • Verbindung über eine Konfigurationsdatei mit einem Standardprofil herstellen:
    /* Use the SignatureProvider to supply your credentials to NoSQL Database.
 * By default, the SignatureProvider will read your OCI configuration file 
 * from the default location, ~/.oci/config. See SignatureProvider for 
 * additional options for reading configurations in other ways. */
SignatureProvider sp = new SignatureProvider();
  • Verbindung über eine Konfigurationsdatei mit einem nicht standardmäßigen Profil herstellen:
    /* Use the SignatureProvider to supply your credentials to NoSQL Database. 
* Specify the full location of the configuration file in the construtor for SignatureProvider. 
*/
final String config_file = "<path_to_config_file>";
SignatureProvider sp = new SignatureProvider(config_file);

  • Mit einem Instanz-Principal anmelden:

    Instanz-Principal ist ein IAM-Servicefeature, mit dem Instanzen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können. Jede Compute-Instanz hat eine eigene Identität und authentifiziert die Zertifikate, die ihr hinzugefügt werden. 
    SignatureProvider authProvider = SignatureProvider.createWithInstancePrincipal();

  • Verbindung mit einem Resource Principal herstellen:

    Resource Principal ist ein IAM-Servicefeature, mit dem die Ressourcen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können.
    SignatureProvider authProvider = SignatureProvider.createWithResourcePrincipal();

Weitere Informationen zu den verwendeten Java-Klassen finden Sie unter SignatureProvider.

Mit einer der folgenden Methoden können Sie eine Verbindung zu NDCS herstellen:
  • Direkte Bereitstellung von Zugangsdaten im Code:
    from borneo.iam import SignatureProvider
#
# Use SignatureProvider directly via API. Note that the
# private_key argument can either point to a key file or be the
# string content of the private key itself.
#
at_provider = SignatureProvider(tenant_id='ocid1.tenancy.oc1..tenancy',
                                user_id='ocid1.user.oc1..user',
                                private_key=key_file_or_key, 
                                fingerprint='fingerprint',   
                                pass_phrase='mypassphrase')
  • Verbindung über eine Konfigurationsdatei mit einem Standardprofil herstellen:
    from borneo.iam import SignatureProvider
#
# Use SignatureProvider with a default credentials file and
# profile $HOME/.oci/config
#
at_provider = SignatureProvider()
  • Verbindung über eine Konfigurationsdatei mit einem nicht standardmäßigen Profil herstellen:
    from borneo.iam import SignatureProvider
#
# Use SignatureProvider with a non-default credentials file and profile
#
at_provider = SignatureProvider(config_file='myconfigfile', 
                                profile_name='myprofile')

  • Mit einem Instanz-Principal anmelden:

    Instanz-Principal ist ein IAM-Servicefeature, mit dem Instanzen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können. Jede Compute-Instanz hat eine eigene Identität und authentifiziert die Zertifikate, die ihr hinzugefügt werden. 
    at_provider =
SignatureProvider.create_with_instance_principal(region=my_region)

  • Verbindung mit einem Resource Principal herstellen:

    Resource Principal ist ein IAM-Servicefeature, mit dem die Ressourcen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können.
    at_provider = SignatureProvider.create_with_resource_principal()
Sie können Ihre Anwendung mit einer der folgenden Methoden mit NDCS verbinden:
  • Direkte Bereitstellung von Zugangsdaten im Code:
    privateKeyFile := "/path/to/privateKeyFile"
passphrase := "examplepassphrase"
sp, err := iam.NewRawSignatureProvider("ocid1.tenancy.oc1..tenancy",
                                       "ocid1.user.oc1..user",
                                       "<your-service-region>", 
                                       "fingerprint", 
                                       "compartmentID", 
                                       privateKeyFile ,
                                       &passphrase )
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    // This is only required if the "region" property is not 
    //specified in the config file.
    Region: "<your-service-region>",
}
  • Verbindung über eine Konfigurationsdatei mit einem Standardprofil herstellen: 
    cfg := nosqldb.Config{
// This is only required if the "region" property is not 
//specified in ~/.oci/config.
// This takes precedence over the "region" property when both are specified.
    Region: "<your-service-region>", 
}
client, err := nosqldb.NewClient(cfg)
  • Verbindung über eine Konfigurationsdatei mit einem nicht standardmäßigen Profil herstellen:
    sp, err := iam.NewSignatureProviderFromFile("your_config_file_path", 
           "your_profile_name", "", "compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    // This is only required if the "region" property is not specified in the config file.
    Region: "us-ashburn-1",
}
client, err := nosqldb.NewClient(cfg)

  • Mit einem Instanz-Principal anmelden:

    Instanz-Principal ist ein IAM-Servicefeature, mit dem Instanzen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können. Jede Compute-Instanz hat eine eigene Identität und authentifiziert die Zertifikate, die ihr hinzugefügt werden. 
    sp, err := iam.NewSignatureProviderWithInstancePrincipal("compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    Region: "<your-service-region>",
}
client, err := nosqldb.NewClient(cfg)

  • Verbindung mit einem Resource Principal herstellen:

    Resource Principal ist ein IAM-Servicefeature, mit dem die Ressourcen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können.
    sp, err := iam.NewSignatureProviderWithResourcePrincipal("compartment_id")
if err != nil {
    return
}
cfg := nosqldb.Config{
    AuthorizationProvider: sp,
    Region: "<your-service-region>",
}
client, err := nosqldb.NewClient(cfg)
Mit einer der folgenden Methoden können Sie eine Verbindung zu NDCS herstellen:

  • Direkte Bereitstellung von Zugangsdaten im Code:

    Sie können Zugangsdaten direkt als Teil der Eigenschaft auth.iam in der anfänglichen Konfiguration angeben. Erstellen Sie die NoSQLClient-Instanz wie folgt:
    import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({
    region: <your-service-region>
    auth: {
        iam: {
            tenantId: myTenancyOCID,
            userId: myUserOCID,
            fingerprint: myPublicKeyFingerprint,
            privateKeyFile: myPrivateKeyFile,
            passphrase: myPrivateKeyPassphrase
        }
    }
});

  • Verbindung über eine Konfigurationsdatei mit einem Standardprofil herstellen:

    Sie können die Zugangsdaten in einer Oracle Cloud Infrastructure-Konfigurationsdatei speichern. Der Standardpfad für die Konfigurationsdatei ist ~/.oci/config, wobei ~ für das Home-Verzeichnis des Benutzers steht. Unter Windows ist ~ ein Wert der Umgebungsvariablen USERPROFILE. Die Datei kann mehrere Profile enthalten. Standardmäßig verwendet das SDK das Profil DEFAULT, um die Zugangsdaten zu speichern.

    Um diese Standardwerte zu verwenden, erstellen Sie eine Datei namens config im Verzeichnis ~/.oci mit dem folgenden Inhalt:
    [DEFAULT]
tenancy=<your-tenancy-ocid>
user=<your-user-ocid>
fingerprint=<fingerprint-of-your-public-key>
key_file=<path-to-your-private-key-file>
pass_phrase=<your-private-key-passphrase>
region=<your-region-identifier>
    Beachten Sie, dass Sie auch Ihre Regions-ID zusammen mit Zugangsdaten in der OCI-Konfigurationsdatei angeben können. Der Treiber prüft standardmäßig den obigen Speicherort. Wenn eine Region zusammen mit Zugangsdaten angegeben wird, müssen Sie keine anfängliche Konfiguration angeben und können den Konstruktor ohne Argumente verwenden:
    import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient();
    Alternativ können Sie die Region in der Konfiguration angeben:
    import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({ region: Region.<your-service-region> });

  • Verbindung über eine Konfigurationsdatei mit einem nicht standardmäßigen Profil herstellen:

    Sie können einen anderen Pfad für die OCI-Konfigurationsdatei sowie ein anderes Profil in der Konfigurationsdatei verwenden. Geben Sie diese in diesem Fall in der Eigenschaft auth.iam der anfänglichen Konfiguration an. Beispiel: Wenn der Pfad der OCI-Konfigurationsdatei ~/myapp/.OCI/config lautet und Sie Ihre Zugangsdaten unter dem Profil Jane speichern:

    Erstellen Sie dann die NoSQLClient-Instanz wie folgt:
    import { NoSQLClient, Region } from 'oracle-nosqldb';
let client = new NoSQLClient({
    region: Region.<your-service-region>,
    auth: {
        iam: {
            configFile: '<your_config_file>',
            profileName: '<name_of_your_profile>'
        }
    }
});

  • Mit einem Instanz-Principal anmelden:

    Instanz-Principal ist ein IAM-Servicefeature, mit dem Instanzen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können. Jede Compute-Instanz hat eine eigene Identität und authentifiziert die Zertifikate, die ihr hinzugefügt werden.

    Nachdem Sie die Instanz NoSQLClient eingerichtet haben, erstellen Sie sie wie folgt:
    import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1..............'
    auth: {
        iam: {
            useInstancePrincipal: true
        }
    }
});
    Sie können auch eine JSON-Konfigurationsdatei mit derselben Konfiguration wie oben beschrieben verwenden. Beachten Sie, dass Sie bei Verwendung des Instanz-Principals die Compartment-ID (OCID) als Compartment-Eigenschaft angeben müssen. Dies ist auch dann erforderlich, wenn Sie das Standard-Compartment verwenden möchten. Beachten Sie, dass Sie die Compartment-ID und nicht den Compartment-Namen oder -Pfad verwenden müssen. Wenn Sie den Instanz-Principal verwenden, können Sie außerdem beim Aufrufen der NoSQLClient-APIs dem Tabellennamen kein Compartment-Name oder -Pfad voranstellen.

  • Verbindung mit einem Resource Principal herstellen:

    Resource Principal ist ein IAM-Servicefeature, mit dem die Ressourcen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können.

    Nachdem Sie die Instanz NoSQLClient eingerichtet haben, erstellen Sie sie wie folgt:
    import { NoSQLClient, Region } from 'oracle-nosqldb';
const client = new NoSQLClient({
    region: Region.<your-service-region>,
    compartment: 'ocid1.compartment.oc1...........................'
    auth: {
        iam: {
            useResourcePrincipal: true
        }
    }
});
    Sie können auch eine JSON-Konfigurationsdatei mit derselben Konfiguration wie oben beschrieben verwenden. Beachten Sie, dass Sie bei Verwendung des Resource Principals die Compartment-ID (OCID) als Compartment-Eigenschaft angeben müssen. Dies ist auch dann erforderlich, wenn Sie das Standard-Compartment verwenden möchten. Beachten Sie, dass Sie die Compartment-ID und nicht den Compartment-Namen oder -Pfad verwenden müssen. Wenn Sie Resource Principal verwenden, dürfen Sie außerdem beim Aufrufen von NoSQLClient-APIs dem Tabellennamen kein Compartment-Name oder Pfad voranstellen.
Mit einer der folgenden Methoden können Sie eine Verbindung zu NDCS herstellen:

  • Direkte Bereitstellung von Zugangsdaten im Code:

    Sie können Zugangsdaten beim Erstellen von IAMAuthorizationProvider direkt als IAMCredentials angeben. Erstellen Sie NoSQLClient wie folgt:
    var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region=<your-service-region>,
        AuthorizationProvider = new IAMAuthorizationProvider(
            new IAMCredentials
            {
                TenantId=myTenancyOCID,
                UserId=myUserOCID,
                Fingerprint=myPublicKeyFingerprint,
                PrivateKeyFile=myPrivateKeyFile
            })
    });

  • Verbindung über eine Konfigurationsdatei mit einem Standardprofil herstellen:

    Sie können die Zugangsdaten in einer Oracle Cloud Infrastructure-Konfigurationsdatei speichern. Der Standardpfad für die Konfigurationsdatei ist ~/.oci/config, wobei ~ für das Home-Verzeichnis des Benutzers steht. Unter Windows ist ~ ein Wert der Umgebungsvariablen USERPROFILE. Die Datei kann mehrere Profile enthalten. Standardmäßig verwendet das SDK das Profil DEFAULT, um die Zugangsdaten zu speichern

    Um diese Standardwerte zu verwenden, erstellen Sie die Datei config im Verzeichnis ~/.oci mit dem folgenden Inhalt:
    [DEFAULT]
tenancy=<your-tenancy-ocid>
user=<your-user-ocid>
fingerprint=<fingerprint-of-your-public-key>
key_file=<path-to-your-private-key-file>
pass_phrase=<your-private-key-passphrase>
region=<your-region-identifier>
    Beachten Sie, dass Sie auch Ihre Regions-ID zusammen mit Zugangsdaten in der OCI-Konfigurationsdatei angeben können. Standardmäßig sucht der Treiber nach Zugangsdaten und einer Region in der OCI-Konfigurationsdatei im Standardpfad und im Standardprofil. Wenn Sie also eine Region zusammen mit Zugangsdaten wie oben gezeigt angeben, können Sie eine NoSQLClient-Instanz erstellen, ohne eine Konfiguration zu übergeben:
    var client = new NoSQLClient();
    Alternativ können Sie die Region (sowie andere Eigenschaften) in NoSQLConfig angeben:
    var client = new NoSQLClient(
    new NoSQLConfig(
    {
        Region = Region.<your-service-region>,
        Timeout = TimeSpan.FromSeconds(10),
    });

  • Verbindung über eine Konfigurationsdatei mit einem nicht standardmäßigen Profil herstellen:

    Sie können einen anderen Pfad für die OCI-Konfigurationsdatei sowie ein anderes Profil in der Konfigurationsdatei verwenden. Geben Sie diese in diesem Fall in der Eigenschaft auth.iam der anfänglichen Konfiguration an. Beispiel: Wenn der Pfad der OCI-Konfigurationsdatei ~/myapp/.OCI/config lautet und Sie Ihre Zugangsdaten unter dem Profil Jane speichern:

    Erstellen Sie dann die NoSQLClient-Instanz wie folgt:
    var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = Region.<your-service-region>,
        AuthorizationProvider = new IAMAuthorizationProvider(
            "<your_config_file>", "<your_profile_name>")
    });

  • Mit einem Instanz-Principal anmelden:

    Instanz-Principal ist ein IAM-Servicefeature, mit dem Instanzen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können. Jede Compute-Instanz hat eine eigene Identität und authentifiziert die Zertifikate, die ihr hinzugefügt werden. Nachdem Sie die Instanz NoSQLClient eingerichtet haben, erstellen Sie sie wie folgt:
    var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region=<your-service-region>,
        Compartment="ocid1.compartment.oc1.............................",
        AuthorizationProvider=IAMAuthorizationProvider.CreateWithInstancePrincipal()
    });
    Sie können dieselbe Konfiguration auch in JSON wie folgt darstellen:
    {
    "Region": "<your-service-region>",
    "AuthorizationProvider":
    {
        "AuthorizationType": "IAM",
        "UseInstancePrincipal": true
    },
    "Compartment": "ocid1.compartment.oc1.............................",
}

    Beachten Sie, dass Sie bei Verwendung des Instanz-Principals die Compartment-ID (OCID) als Eigenschaft compartment angeben müssen. Dies ist auch dann erforderlich, wenn Sie das Standard-Compartment verwenden möchten. Beachten Sie, dass Sie die Compartment-ID und nicht den Compartment-Namen oder -Pfad verwenden müssen. Wenn Sie den Instanz-Principal verwenden, können Sie außerdem beim Aufrufen der NoSQLClient-APIs dem Tabellennamen kein Compartment-Name oder -Pfad voranstellen.

  • Verbindung mit einem Resource Principal herstellen:

    Resource Principal ist ein IAM-Servicefeature, mit dem die Ressourcen als autorisierte Akteure (oder Principals) Aktionen an Serviceressourcen ausführen können. Nachdem Sie die Instanz NoSQLClient eingerichtet haben, erstellen Sie sie wie folgt:
    var client = new NoSQLClient(
    new NoSQLConfig
    {
        Region = <your-service-region>,
        Compartment =
            "ocid1.compartment.oc1.............................",
        AuthorizationProvider =
            IAMAuthorizationProvider.CreateWithResourcePrincipal()
    });
    Sie können dieselbe Konfiguration auch in JSON wie folgt darstellen:
    {
    "Region": "<your-service-region>",
    "AuthorizationProvider":
    {
        "AuthorizationType": "IAM",
        "UseResourcePrincipal": true
    },
    "Compartment": "ocid1.compartment.oc1.............................",
}

    Beachten Sie, dass Sie bei Verwendung des Resource Principals die Compartment-ID (OCID) als Eigenschaft compartment angeben müssen. Dies ist auch dann erforderlich, wenn Sie das Standard-Compartment verwenden möchten. Beachten Sie, dass Sie die Compartment-ID und nicht den Compartment-Namen oder -Pfad verwenden müssen. Wenn Sie Resource Principal verwenden, dürfen Sie außerdem beim Aufrufen von NoSQLClient-APIs dem Tabellennamen kein Compartment-Name oder Pfad voranstellen.

Typischer Workflow

Typische Aufgabenfolge für das Arbeiten mit Oracle NoSQL Database Cloud Service.

Wenn Sie zum ersten Mal Anwendungen entwickeln, die Oracle NoSQL Database Cloud Service verwenden, befolgen Sie diese Aufgaben als Richtlinie.

Aufgabe Beschreibung Weitere Informationen
Anwendung verbinden Stellen Sie eine Verbindung mit Ihrer Anwendung her, um Oracle NoSQL Database Cloud Service-Tabellen zu verwenden. Anwendung mit NDCS verbinden
Ihre Anwendung entwickeln Entwickeln Sie Ihre Anwendung, nachdem Sie eine Verbindung zu Oracle NoSQL Database Cloud Service-Tabellen hergestellt haben. In Oracle Cloud entwickeln

In Oracle NoSQL Database Cloud Simulator entwickeln

Wenn Sie Oracle NoSQL Database Cloud Service zum ersten Mal einrichten, finden Sie weitere Informationen unter Service einrichten.

Schnellstart-Tutorials

Rufen Sie Schnellstart-Tutorials auf, und steigen Sie in die Arbeit mit dem Service ein.

  1. Erhalten Sie Zugriff auf den Service.

    Registrieren Sie sich für eine Cloud-Promotion, oder erwerben Sie ein Oracle Cloud. Aktivieren Sie Ihre Bestellung, erstellen Sie Benutzer (optional). Siehe Service einrichten.

  2. Fordern Sie Zugangsdaten für die Verbindung mit Ihrer Anwendung an. Siehe Authentifizierung für die Verbindung mit Oracle NoSQL Database.

  3. Erstellen Sie eine Tabelle in Oracle NoSQL Database Cloud Service.