5 Administrere databasetilkoblinger for modellering av data

Administratorer oppretter og administrerer skydatabasetilkoblinger for modellering av relasjonelle og ikke-relasjonelle data som Essbase-, Snowflake- eller Oracle Enterprise Performance Management-data (Oracle EPM). Forretningsdataene trenger ikke være på én plass. Koble til flere skydatabaser, slik at forretningsmodellerere og -analytikere kan analysere selskapsdata uansett hvor de er lagret.

Emner

Modellere data i en Essbase-kube

Koble til en Essbase-database slik at du kan modellere og visualisere data fra Essbase-kuber.

Du kan bare modellere Essbase-data i modelladministrasjonsverktøyet.
Før du begynner, må du implementere Data Gateway med Oracle Analytics-forekomsten og konfigurer en Data Gateway-agent som kommuniserer med den eksterne Essbase-implementeringen.
  1. I det fysiske laget oppretter du en database:
    1. Høyreklikk i ruten Fysisk lag og velg Opprett ny database.
    2. Angi et navn som identifiserer databasen i Oracle Analytics, i dialogboksen Database.
    3. Velg databasetypen (for eksempel Essbase 11), og klikk deretter på OK.
  2. I det fysiske laget oppretter du en tilkoblingsreserve:
    1. Høyreklikk på den nye databasen, klikk på Opprett nytt objekt og velg deretter Databasetilkoblingsreserve.
    2. Angi et navn som identifiserer databasereserven i Oracle Analytics, i dialogboksen Tilkoblingsreserve.
    3. I Essbase-tjener angir du tilkoblingsstrengen for Essbase-tjeneren.
      For eksempel http://<IP-adresse>:<portnummrt>/essbase/agent.
    4. Velg Bruk Data Gateway.
    5. Angi Brukernavn og Passord for Essbase-implementeringen.
    6. Hvis du blir bedt om det, angir du passordet for Essbase-implementeringen på nytt.
  3. I det fysiske laget importerer du Essbase-metadataene:
    1. Høyreklikk på Essbase-tilkoblingen og velg Importer metadata.
    2. På siden Velg datakilde klikker du på Neste.
    3. På siden Velg metadataobjekter utvider du databasen i boksen Datakilde. Velg kuben du ønsker, og klikk deretter på Importer valgte.

      For en stor kube kan importen ta to til tre minutter.

    4. Når importen er fullført, utvider du databasen i Registervisning slik at du viser den importerte Essbase-kuben.
    5. Klikk på Fullfør.
  4. Ved hjelp av det fysiske laget du nettopp opprettet, oppretter du forretningsmodellen og tilordningslaget, og presentasjonslaget.
  5. Klikk på Fil, Sky og deretter på Publiser.
  6. Opprett et instrumentpanel eller en visualiseringsarbeidsbok basert på Essbase-kuben.
    Den nye Essbase-kuben er nå tilgjengelig som emneområde i Oracle Analytics.
    I Oracle Analytics kan du for eksempel opprette en analyse, og du kan få tilgang til det nye Essbase-emneområdet i dialogboksen Velg emneområde. Opprett en arbeidsbok i Oracle Analytics, og klikk på Emneområder i dialogboksen Legg til datasett for å få tilgang til det nye Essbase-emneområdet.

Modellere data i Snowflake Data Warehouse

Konfigurer det lokale miljøet slik at du kan modellere data i en Snowflake-database.

Du kan modellere Snowflake-data i den semantiske modellereren eller modelladministrasjonsverktøyet. Denne oppgaven beskriver prosessen med modelladministrasjonsverktøyet.
Både lokale og eksterne tilkoblinger til Snowflake fra en semantisk modell må ha en installasjon av Data Gateway hvis Model Administration Tool skal kunne importere og modellere tabeller fra en Snowflake-datakilde. Konfigurer Data Gateway-agenten med en passende driver for å koble til Snowflake. Kontroller at eksterne Data Gateway-tilkoblinger er tilgjengelige når det kjøres spørringer. Når Snowflake-tabellene er modellert og den semantiske modellen er publisert til Oracle Analytics, kan imidlertid Data Gateway deaktiveres eller fjernes for lokale tilkoblinger, ettersom det ikke brukes når spørringer kjøres fra Oracle Analytics.

Du kan opprette en lokal eller en ekstern tilkobling til Snowflake fra den semantiske modellen. Når du oppretter en lokal (ikke ekstern) tilkobling, bruker tilkoblingsreserven i den semantiske modellen en JDBC-tilkobling.

Før du begynner, må du installere Data Gateway og Model Administration Tool på samme Windows-datamaskin i det lokale miljøet.
  1. Konfigurer en lokal Data Gateway-agent hvis du vil opprette en tilkobling fra utviklerklientverktøyet til Snowflake.
    1. Last ned den nyeste JDBC-driveren for Snowflake (for eksempel i filen Snowflake-jdbc-3.9.0.jar).
    2. Kopier den nedlastede JAR-filen til installasjonsmappen for Data Gateway.
      I en tjenerimplementering kopierer du JAR-filen til:
      <Data Gateway-mappe>/domain/jettybase/lib/ext
      I en personlig implementering kopierer du JAR-filen til:
      <installasjonskatalog>\war\datagateway\WEB-INF\lib
    3. Start Data Gateway på nytt.
  2. Konfigurer en tilkobling til Snowflake-databasen.
Du kan nå modellere dataene ved hjelp av denne tilkoblingen.

Opprette en lokal tilkobling til Snowflake for semantiske modeller

Koble til en lokal Snowflake-database, slik at du kan modellere Snowflake-data.

  1. I Model Administration Tool aktiverer du funksjonene for JDBC-tilkoblingsreserven ved å laste inn Java-datakilder. Se trinn 3 i Konfigurere og registrere Data Gateway for rapportering.
  2. Opprett en database i modelladministrasjonsverktøyet, og sett typen til Snowflake.
  3. Legg til en tilkoblingsreserve, og angi disse detaljene i fanen Generelt:
    • Kallgrensesnitt: JDBC (direkte driver).
    • Krev fullstendig kvalifiserte tabellnavn: Ja.
    • Datakildenavn: Angi tillkoblingsstrengen, for eksempel jdbc:snowflake://xxxx.snowflakecomputing.com?db=ODEV&warehouse=xxxxxx&schema=xxxxxx
    • RDC-versjon: La dette feltet stå tomt.
  4. Angi følgende detaljer i fanen Diverse:
    • URL-adresse for JDS-tjener: La dette feltet stå tomt (fjern eventuelle oppføringer i dette feltet).
    • Driverklasse: net.snowflake.client.jdbc.SnowflakeDriver.
    • Bruk SQL over HTTP: usann.
  5. Modeller dataene ved hjelp av denne tilkoblingen.
  6. Last opp eller publiser den semantiske modellen til Oracle Analytics Cloud når du har fullført modellen.
    Oracle Analytics Cloud kobler til Snowflake-databasen uten å bruke Data Gateway.
Du kan nå modellere dataene ved hjelp av denne tilkoblingen.

Opprette en ekstern tilkobling til Snowflake for semantiske modeller

Koble til en lokal Snowflake-database, slik at du kan modellere Snowflake-data.

  1. I Model Administration Tool aktiverer du funksjonene for JDBC-tilkoblingsreserven ved å laste inn Java-datakilder. Se trinn 3 i Konfigurere og registrere Data Gateway for rapportering.
  2. Opprett en database i modelladministrasjonsverktøyet, og sett typen til Snowflake.
  3. Legg til en tilkoblingsreserve, og angi disse detaljene i fanen Generelt:
    • Kallgrensesnitt: JDBC (direkte driver).
    • Krev fullstendig kvalifiserte tabellnavn: Ja.
    • Datakildenavn: Angi tillkoblingsstrengen, for eksempel jdbc:snowflake://xxxx.snowflakecomputing.com?db=ODEV&warehouse=xxxxxx&schema=xxxxxx
    • RDC-versjon: Sett den til 2.
  4. Angi følgende detaljer i fanen Diverse:
    • URL-adresse for JDS-tjener: La dette feltet stå tomt (fjern eventuelle oppføringer i dette feltet).
    • Driverklasse: net.snowflake.client.jdbc.SnowflakeDriver.
    • Bruk SQL over HTTP: sann.
  5. Modeller dataene ved hjelp av denne tilkoblingen.
  6. Last opp eller publiser den semantiske modellen til Oracle Analytics Cloud når du har fullført modellen.
    Merknad: Oracle Analytics Cloud kobler til Snowflake ved hjelp av en hvilken som helst konfigurert Data Gateway-agent.
  7. Kopier Snowflake-driverfilen til hver enkelt installasjonsmappe for Data Gateway-agenten.
    • I en tjenerimplementering kopierer du JAR-filen til <Data Gateway install_location>/domain/jettybase/thirdpartyDrivers.
    • I en personlig implementering på Windows kopierer du JAR-filen til <Data Gateway_extract_path>\thirdpartyDrivers.
    • I en personlig implementering på MacOS kopierer du JAR-filen til <Applikasjon->Vis pakkeinnhold>Ressurser->app.nw-> thirdpartyDrivers.
  8. Start Data Gateway på nytt. Se Vedlikeholde Data Gateway.

Modellere data i Google BigQuery

Koble til en Google BigQuery-database, slik at du kan modellere og visualisere data fra Google BigQuery. Du kan modellere Google BigQuery-data i den semantiske modellereren eller modelladministrasjonsverktøyet. Disse oppgavene beskriver prosessen med modelladministrasjonsverktøyet.

Emner

Opprette en Oracle Analytics-tilkobling til Google BigQuery

Du kan opprette en systemtilkobling til en Google BigQuery-database og bruke tilkoblingen til å modellere Google BigQuery-prosjektet.

Last ned privatnøkkelen for tjenestekontoen (i JSON-format) for Google BigQuery-tjenesten før du begynner.
  1. På hjemmesiden for Oracle Analytics klikker du på Opprett og deretter på Tilkobling.
  2. Klikk på BigQuery.
  3. Angi tilkoblingsdetaljene.
    • I Tilkoblingsnavn angir du et brukervennlig navn for identifikasjon av tilkoblingsdetaljene i Oracle Analytics.
    • Angi BigQuery-prosjektnavnet med små bokstaver for prosjektet du vil analysere, i Prosjekt.
    • Klikk på Velg i Privatnøkkel for tjenestekonto, og last opp privatnøkkelen for tjenestekontoen (JSON-format) for BigQuery-tjenesten. E-postadresse for tjenestekonto fylles ut fra nøkkeldetaljene som er lastet opp.
    • Angi dette valget i Systemtilkobling.
      Beskrivelse av GUID-62C22DE3-F4DC-4050-AA35-4BAD55E9F5D0-default.png følger
      .png

  4. Lagre detaljene.

Laste ned og konfigurere en ODBC-driver for BigQuery

Installer ODBC-driveren som er nødvendig for tilkobling til Google BigQuery, og konfigurer den i modelladministrasjonsverktøyet for å kunne modellere prosjektet.

  1. Last ned ODBC-driveren for Simba BigQuery fra Google.
    Du kan for eksempel laste den ned fra Google-referanseområdet.
  2. Installer den nedlastede driveren på maskinen der klientverktøy for Oracle Analytics er installert.
  3. Konfigurer ODBC-driveren ved hjelp av dialogboksen for DSN-oppsett.
    Beskrivelse av GUID-450ABCF1-472B-4A80-9F49-CC59E6564AA4-default.png følger
    .png

  4. Klikk på Test for å teste tilkoblingen.
    Beskrivelse av GUID-65677628-F0C0-4018-B7DF-39D6726D3D3C-default.png følger
    .png

  5. Lagre detaljene.

Bygge en datamodell fra en Google BigQuery-datakilde

Du bygger en datamodell for Google BigQuery-databasen, slik at du kan implementere den for å visualisere data i et BigQuery-prosjekt.

Hvis du skal bygge en datamodell, trenger du tillatelser i BigQuery-nøkkelen. Hvis BigQuery-nøkkelen gir tilgang til datasettnivået, importerer du ganske enkelt metadata ved hjelp av ODBC-driveren for BigQuery ved å følge fremgangsmåten nedenfor. Hvis BigQuery-nøkkelen bare gir tilgang til spesifikke tabeller eller visninger, følger du trinnene nedenfor for å opprette et fysisk skjema.
  1. Opprett en database i registeret i modelladministrasjonsverktøyet, og sett Databasetype til ODBC Basic.
    Beskrivelse av GUID-407BFD6D-8629-4578-B218-FC0DF46B3583-default.png følger
    .png

  2. Opprett en tilkoblingsreserve i databasen i dialogboksen Tilkoblingsreserver.
    • Velg Standard (ODBC 2.0) i Kallgrensesnitt.

    • Velg ODBC-driveren for BigQuery du opprettet tidligere, i feltet Datakildenavn.

  3. Opprett et fysisk skjema i databasen med samme navn som BigQuery-datasettet.
    BigQuery SQL forutsetter at datasettnavnet settes inn foran tabellnavnet, dataset.table. Datasettnavnet tilsvarer et fysisk skjemaobjekt i registerfilen.
  4. Høyreklikk på tilkoblingsreserven, og velg Importer metadata.
  5. Velg ODBC 2.0 eller ODBC 3.5 som tilkoblingstype i dialogboksen Velg datakilde, og velg ODBC-driveren for BigQuery.
    Beskrivelse av GUID-DA7BA215-A363-457B-8DDE-FF9B7198DA2C-default.png følger
    .png

  6. Velg Visninger i dialogboksen Velg metadatatyper og eventuelle andre typer du vil bruke, og som BigQuery-nøkkelen har tillatelser for.
    Beskrivelse av GUID-9715097D-495D-4A39-AD3C-1D47A973A8F2-default.png følger
    .png

  7. Velg de enkelte tabellene i dialogboksen Velg metadatatyper, og klikk deretter på Importer valgte. Dette importerer BigQuery-databasen og de underliggende strukturene.
    Beskrivelse av GUID-599435ED-DB4D-48ED-87AA-1DC439D518E3-default.png følger
    .png

    Hvis du klikker på Importer alle, importerer du bare databasen. Hvis dette skjer, velger du Importer alle på nytt for å importere tabellene.
  8. Klikk på Fullfør.
  9. Dra importerte tabeller til fysisk skjema.
  10. Rediger den fysiske databasen, og endre databasetypen til BigQuery.

    Når du endrer den fysiske databasen, ser du en melding om at databasetypen ikke samsvarer med kallgrensesnittet som er angitt i tilkoblingsreserven. Klikk på Ja.

  11. Konfigurer disse innstillingene i dialogboksen Tilkoblingsreserve:
    • Endre kallgrensesnittet til JDBC (direkte driver) i Kallgrensesnitt.
    • Velg Krev fullstendig kvalifiserte tabellnavn.
    • Velg Bruk datatilkobling.
    • Undersøk BigQuery-tilkoblingen i Oracle Analytics, og kopier objekt-ID-en. BigQuery skiller mellom store og små bokstaver. Bruk knappen Kopier for å sikre at datatilkoblingssyntaksen er riktig.
      Beskrivelse av GUID-976116CC-2CC9-4109-AFCC-B408373E0A81-default.png følger
      .png

    • Lim inn den kopierte objekt-ID-en i feltet Objekt-ID i dialogboksen Tilkoblingsreserve.
    • Sett Maksimalt antall tilkoblinger til 100.
  12. Lagre detaljene.
Modeller metadataene i registeret, og last opp registerfilen (RPD) i Oracle Analytics.

Feilsøke problemer med registertilkobling for Google BigQuery

Her er noen problemer du kan støte på når du kobler til Google BigQuery, samt tips om hvordan du løser dem.

Hvis det ikke er merket av for Nødvendig: fullstendige tabellnavn og et fysisk skjema ikke er en del av generert SQL, mislykkes spørringer med meldingen Kan ikke lese data fra Java-datakildetjeneren.

Hvis spørringen kjøres mot BigQuery ved hjelp av nqcmd eller et annet SQL-registreringsverktøy, vises den faktiske feilmeldingen:

WITH SAWITH0 AS (select distinct T4.PROP_CD as c1 from FINOPS_RM_OCC_ACT T4) select 0 as c1, D1.c1 as c2 from SAWITH0 D1 order by c2
[Simba][BigQuery] (70) Invalid query: Table "FINOPS_RM_OCC_ACT" must be qualified with a dataset (e.g. dataset.table).
Statement preparation failed

Måten du kvalifiserer en spørring på med et datasett, er å bruke et fysisk skjema i registerfilen.

Hvis Oracle Analytics-tilkoblingen bruker et prosjektnavn med store bokstaver, opprettes tilkoblingen.

Du kan oppleve to ulike problemer.

1. Spørringer mislykkes med en 404-melding (Ikke funnet) om en maskert URL-adresse:

[2022-03-17T01:13:44.105+00:00] [OBIS] [TRACE:2] [USER-34] [] [ecid: d6382db0-1e63-427e-893b-18bc00c0424e-0000de96,0:2:1:5] [sik: bootstrap] [tid: 856a6700] [messageId: USER-34] [requestid: 6358001e] [sessionid: 63580000] [username: Testuser] -------------------- Query Status: [nQSError: 46164] HTTP Server returned 404 (Not Found) for URL [masked_url]. [[
[nQSError: 46281] Failed to download metadata for dataset ‘system’.‘BigQuery Test’.
[nQSError: 43119] Query Failed:

2. Du ser datasett i Oracle Analytics, men de underliggende tabellene er ikke tilgjengelige.
Beskrivelse av GUID-1C0811AA-3875-4A7C-A147-230688B98583-default.png følger
.png

I begge tilfeller kan du endre tilkoblingen slik at prosjektnavnet er med små bokstaver.

Ved feilsøking av BigQuery-tilkoblinger i Oracle Analytics Cloud bruker du en tredjeparts JDBC-klient til å prøve å koble til BigQuery ved hjelp av den samme nøkkelen for tjenestekonto.

Hvis tilkoblingen fortsatt mislykkes, er det et problem med nøkkelen for tjenestekonto.

Hvis tilkoblingen lykkes, er det et problem med Oracle Analytics, og du må kontakte Oracle Support.

Denne testen er nyttig i tilfeller der nøkkelen for tjenestekonto ikke er verifisert via ODBC.

DSN-formater for angivelse av datakilder

Du kan modellere de lokale dataene for mange databasetyper i Oracle Analytics. Oracle Analytics støtter direkte tilgang til enkelte lokale datakilder via den semantiske modellen. Når du oppretter en databasetilkobling ved hjelp av Model Administration Tool, bruker du feltet Datakildenavn i dialogboksen Tilkoblingsreserve (fanen Generelt) til å angi riktig DSN-format for databasetypen du kobler til.

Amazon Redshift:
       DRIVER=Oracle 7.1 Amazon Redshift Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
      SSL: DRIVER=Oracle 7.1 Amazon Redshift Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"];EM=6;CPV=TLSv1.2,TLSv1.1,TLSv1, SSLv3, SSLv2;VSC=0
Apache Drill:
       DRIVER=MapR Drill ODBC Driver;Host=["host-name"];Port=["port"];CastAnyToVarchar=true;ExcludedSchemas=sys,INFORMATION_SCHEMA;AuthenticationType=Basic               Authentication;ConnectionType=Direct
Aster:
       DRIVER=Aster ODBC Driver;SERVER=["host-name"];PORT=["port"];DATABASE=["service-name"]
DB2:
      DRIVER=Oracle 7.1 DB2 Wire Protocol;IpAddress=["host-name"];PORT=["port"];DB=["service-name"]
      SSL:  DRIVER=Oracle 7.1 DB2 Wire Protocol;IpAddress=["host-name"];PORT=["port"];DB=["service-name"];EM=1;VSC=0
Greenplum:
       DRIVER=Oracle 7.1 Greenplum Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
Hive:
       DRIVER=Oracle 8.0 Apache Hive Wire Protocol;HOST=["host-name"];PORT=["port"]
      SSL: DRIVER=Oracle 8.0 Apache Hive Wire Protocol;HOST=["host-name"];PORT=["port"];EM=1;VSC=0
Impala:
       DRIVER=Oracle 7.1 Impala Wire Protocol;HOST=["host-name"];PORT=["port"]
     SSL:  DRIVER=Oracle 7.1 Impala Wire Protocol;HOST=["host-name"];PORT=["port"];EM=1;VSC=0
Informix:
       DRIVER=Oracle 7.1 Informix Wire Protocol;HOSTNAME=["host-name"];PORTNUMBER=["port"];DATABASE=["service-name"]
MongoDB:
       DRIVER=Oracle 8.0 MongoDB;HOST=["host-name"];PORT=["port"];DB=["service-name"]
MySQL:
      DRIVER=Oracle 7.1 MySQL Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
PostgresSql:
       DRIVER=Oracle 7.1 PostgreSQL Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
Spark:
      DRIVER=Oracle 8.0 Apache Spark SQL;HOST=["host-name"];PORT=["port"]
      SSL:  DRIVER=Oracle 8.0 Apache Spark SQL;HOST=["host-name"];PORT=["port"];EM=1;VSC=0
SQL Server:
     DRIVER=Oracle 7.1 SQL Server Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"]
     SSL:  DRIVER=Oracle 7.1 SQL Server Wire Protocol;HOST=["host-name"];PORT=["port"];DB=["service-name"];EM=1;VSC=0;CryptoProtocolVersion=TLSv1.2,TLSv1.1,TLSv1,SSLv3,SSLv2
Sybase:
       DRIVER=Oracle 7.1 Sybase Wire Protocol;NA=["host-name"], ["port"];DB=["service-name"]
Teradata:
       DRIVER=Oracle 7.1 Teradata;DBCName=["host-name"];port_name=["port"]