Gegevensvernieuwingen plannen in Google Sheets

Op deze pagina wordt beschreven hoe u automatische gegevensvernieuwingen plant in de Databricks Connector voor Google Sheets om uw geïmporteerde gegevens up-to-date te houden. Geplande vernieuwingen voeren uw opgeslagen query's op terugkerende basis uit en werken de bijbehorende bladen bij.

Requirements

Een Unity Catalog-verbinding maken

Geplande vernieuwingen vereisen het volgende:

  • Een Unity Catalog-verbinding met de naam databricks_google_connection, gemaakt door een metastore-beheerder in Google Sheets.
  • De USE CONNECTION bevoegdheid voor de verbinding, verleend aan gebruikers die geplande vernieuwingen moeten maken of beheren.
  1. Als Azure Databricks metastore-beheerder opent u in Google Sheets de Databricks Connector voor Google Sheets sidebar.
  2. Klik op het tabblad Opgeslagen importbewerkingen .
  3. Klik op de agenda in de rechterbovenhoek.
  4. Klik op Verbinding instellen.

Deel een verbinding in Azure Databricks

Nadat de verbinding is gemaakt, verleent u de USE CONNECTION bevoegdheid aan gebruikers die geplande vernieuwingen moeten maken of beheren. Een metastore-beheerder of een gebruiker met de MANAGE bevoegdheid voor de verbinding kan deze bevoegdheid verlenen. Zie Verbindingen beheren voor Lakehouse Federation voor meer informatie over het beheren van verbindingen.

Een planning maken

Elke import kan worden toegewezen aan slechts één planning. Ga als volgt te werk om een nieuw schema voor een bestaande import te maken:

  1. Klik in de zijbalk van de Azure Databricks connector in Google Sheets op het tabblad Saved imports.

  2. Klik op het agendapictogram en klik op Nieuw schema.

  3. Selecteer de import waarvoor u een planning wilt opstellen.

  4. Voer een naam in voor de planning.

  5. Selecteer de frequentie van uw planning:

    • Selecteer voor Elk uur de minuut van het uur om de vernieuwing uit te voeren.
    • Selecteer voor Dagelijks het tijdstip waarop de vernieuwing moet worden uitgevoerd.
    • Selecteer voor Wekelijks de dag van de week en de tijd om de vernieuwing uit te voeren.

    De planning maakt gebruik van uw lokale tijdzone.

  6. Selecteer het SQL Warehouse dat u wilt gebruiken voor de geplande query's.

  7. Klik op Planning maken.

Uitvoeringsgeschiedenis en planningsgegevens weergeven

Ga als volgt te werk om de uitvoeringsgeschiedenis van al uw geplande vernieuwingen te bekijken:

  1. Klik in de zijbalk van de Azure Databricks connector in Google Sheets op het tabblad Saved imports.
  2. Klik op het agendapictogram en klik op Uitvoeringsgeschiedenis weergeven.
  3. Klik op een specifieke run om de details van het schema te bekijken.

Ga als volgt te werk om de uitvoeringsgeschiedenis en configuratiedetails van een geplande vernieuwing weer te geven:

  1. Selecteer in het deelvenster Uitvoeringsgeschiedenis weergeven de naam van het schema dat u wilt bekijken. Onder Recente uitvoeringen wordt de status van elke uitvoering weergegeven.

  2. Beweeg de muisaanwijzer over een statuspictogram om de uitvoerings-id, de begintijd en de uitvoeringsstatus van een uitvoering weer te geven.

    Beweeg de muisaanwijzer over een pictogram van de uitvoeringsstatus in recente uitvoeringen om details van afzonderlijke uitvoeringen weer te geven

  3. Klik op Configuratie weergeven om de planningsgegevens weer te geven, waaronder de geselecteerde import- en planningsconfiguratie.

    • Als u een schema bekijkt dat door iemand anders is gemaakt, is de weergegeven tijd de tijd in de lokale tijdzone van de maker.

Een geplande vernieuwing verwijderen

Ga als volgt te werk om de geplande vernieuwingen te verwijderen:

  1. Klik in de zijbalk van de Azure Databricks connector in Google Sheets op het tabblad Saved imports.
  2. Klik op het agendapictogram en klik op Planningen beheren.
  3. Selecteer het schema dat u wilt verwijderen.
  4. Klik op Configuratie weergeven en klik vervolgens op Verwijderen.

Troubleshooting

Voor de fout met verlopen of ingetrokken token, zie Geplande verversing mislukt omdat de Google-token is verlopen of is ingetrokken.

Voor andere problemen met je geplande verversingen verwijder je de planning in Google Sheets en de bijbehorende Unity Catalog-verbindingen in Azure Databricks, en maak je de planning opnieuw. Zie Verbindingen beheren voor Lakehouse Federation voor meer informatie over Unity Catalog-verbindingen.

Geplande verversing mislukt omdat de Google-token is verlopen of is ingetrokken

Een geplande verversing kan falen met een fout die lijkt op de volgende:

BAD_REQUEST: The OAuth token exchange failed with HTTP status code 400 Bad Request. ... Map(error -> invalid_grant, error_description -> Token has been expired or revoked.)

In de zijbalk van de connector toont de uitvoeringsgeschiedenis: Laatste run mislukte omdat Google Sheets-gegevens ontbreken of verlopen zijn. Autoriseer de verbinding opnieuw vanuit Setup connection.

Deze fout betekent dat de Google-autorisatie die voor de planningseigenaar is opgeslagen niet langer geldig is. Veelvoorkomende oorzaken zijn onder andere:

  • De gebruiker verwijderde de toegang van de connector tot zijn Google-account.
  • Een Google Workspace-beheerdersbeleid heeft het token ingetrokken of beperkt.
  • De toestemming werd zes maanden lang niet gebruikt. Zie vervaldatum van het vernieuwingstoken in de Google-documentatie.

Om de fout te verhelpen, autoriseert de planningseigenaar Google Sheets opnieuw:

  1. Klik in de zijbalk van de Azure Databricks connector in Google Sheets op het tabblad Saved imports.
  2. Klik bovenaan het tabblad op het pictogram 'acties plannen' rechts van het ververs-icoon. Klik dan op Verbinding instellen.
  3. Klik op Google Sheets autoriseren en voltooi de Google-inlog.

De dialoogdialoog toont aan dat Google Sheets-autorisatie actief is. Je bestaande schema's worden hervat bij hun volgende geplande uitvoering. Je hoeft ze niet opnieuw te maken.

Als Authorize Google Sheets niet wordt weergegeven, vraag dan een beheerder van de metastore om je gebruikersgegevens op de databricks_google_connection verbindingspagina in Catalog Explorer in te trekken. Herhaal dan deze stappen.

Beperkingen

  • U kunt een geplande vernieuwing niet bewerken. U kunt bestaande planningen alleen weergeven of verwijderen. Als u een planning wilt wijzigen, verwijdert u deze en maakt u een nieuwe.
  • Als u een query bewerkt die door een planning wordt gebruikt, worden uw wijzigingen niet automatisch door het schema opgehaald. Als u de bijgewerkte querytekst wilt toepassen, verwijdert u de planning en maakt u deze opnieuw.
  • U kunt geen vernieuwing plannen voor draaitabellen. De Google API werkt alleen de onbewerkte querygegevens bij en kan de draaiconfiguratie niet wijzigen als het schema voor queryresultaten wordt gewijzigd.
  • Eén schema kan maximaal 20 importbewerkingen omvatten.
  • Querytekst voor importbewerkingen die worden gebruikt in een geplande vernieuwing, heeft een limiet van 4096 tekens.
  • Laatst bijgewerkt om