Funkcja AFnGSheets()

Alias: GETDATAGSHEETS()

GVAQL - "Google Visualization API Query Language" - dzisiejsza nazwa języka zapytań dla funkcji QUERY w Google Sheets.

Funkcja pobiera dane z UDOSTĘPNIONYCH Arkuszy Google (Google Sheets - GS) - posiada formę pojedynczej wartości oraz wartości tablicowej. Idea funkcji AFnGSheets jest podobna do idei oryginalnej funkcji GS - funkcji QUERY(). Funkcja QUERY jako pierwszy argument ma arkusz - tabele, z której bierze dane, a drugim argumentem jest zapytanie GVAQL. Czyli pierwszy argument jest po prostu klauzulą FROM w SQLu i dlatego nie ma klauzuli FROM w GVAQL-u. "SELECT *" oznacza "SELECT * [FROM tabela, podana jako pierwszy argument funkcji]"
Funkcja AFnGSheets robi dokładnie to samo - tylko z poziomu naszego Excela - potrzebuje więc więcej argumentów, bo musi ten arkusz określić i odnaleźć w systemie arkuszy GS.

Wywołanie funkcji

(=)AFnGSheets(strGoogleSheetId; [strSheetName]; [strRangeAddress]; [strQueryText])

Argumenty

strGoogleSheetId (wymagany) - numer ID (identyfikator) arkusza Google Sheets (GS) - może być podany jako:

* Wyłącznie numer ID arkusza, czyli x-znakowy, unikatowy numer arkusza, np. "1wCsHM1_Nz9d_Ouu0TKZ5tyJin198PMvi5JX-525aDPk"
* Cały URL danego arkusza GS - jest to niekiedy wygodniejsze, bo wystarczy zaznaczyć URL-a, skopiować go i wkleić jako parametr dla funkcji, np. "https://docs.google.com/spreadsheets/d/1wCsHM1_Nz9d_Ouu0TKZ5tyJin198PMvi5JX-525aDPk/edit#gid=335901242"

strSheetName (opcjonalny) - nazwa arkusza

Nazwa arkusza GS. Gdy nie jest podany, domyślnym arkuszem jest arkusz pierwszy od lewej.
Aby pominąć parametr, możemy albo wpisać "" - ciąg pusty, albo nic.

strRangeAddress (opcjonalny) - adres obszaru

Adres komórki lub obszaru (zbioru komórek) arkusza GS. Gdy adres nie jest podany, domyślnie przyjmowany jest cały arkusz.
Aby pominąć parametr, możemy albo wpisać "" - ciąg pusty, albo nic (separatory zostają).

strQueryText (opcjonalny) - zapytanie w języku GVAQL

"SELECT *" - wybierz wszystkie kolumny,
"SELECT A, B" - wybierz tylko wybrane kolumny - uwaga, nie opdajemy tutaj nazw kolumn, jak w SQL-u, tylko nazwy arkuszowe tych kolumn.
"SELECT A, SUM(B) - operacja niemożliwa bez określenia sposobu grupowania
"SELECT A, SUM(B) GROUP BY A - Grupowanie kolumny A i sumowanie kolumny B według grup w kolumnie A - czyli tak, jak w SQL!
"WHERE, HAVING, ORDER BY, LIMIT - działają tak, jak w SQL (dialekt MySQL).
Aliasy kolumn podaje się na końcu, jako dodatkową klauzulę LABEL: "SELECT * LABEL A 'Column A'" - zobacz najpierw pomoc GS, dotyczącą funkcji QUERY(), a potem Pomoc języka GVAQL.