Jak usunąć metadane z Dysku Google: kompletny przewodnik i przypadki szczególne

Informatec Digital » Chmura » Jak usunąć metadane z Dysku Google: kompletny przewodnik i przypadki szczególne

Eliminuj metadane na Dysku Google

Jeśli martwisz się, jakie dodatkowe informacje są przesyłane wraz z plikami w chmurze, prawdopodobnie zastanawiałeś się, jak oczyścić lub kontrolować te niewidoczne dane. W Dysku Google metadane obejmują zarówno tagi i indeksowany tekst, jak i miniatury oraz właściwości plików. Kluczem jest zrozumienie, co można usunąć, co można jedynie zaktualizować, a czego nie można zmienić , aby móc działać precyzyjnie, nie psując niczego.

W tym przewodniku zebraliśmy w jednym miejscu informacje rozproszone w różnych oficjalnych dokumentach Google i artykułach pomocy. Dowiesz się, jak usuwać metadane tagów z pliku, zarządzać indeksowalnym tekstem i miniaturami oraz zrozumieć limity i wyjątki . Wyjaśniamy również podobne scenariusze (transfery do Cloud Storage i metadane maszyn wirtualnych w Compute Engine), aby uniknąć nieporozumień podczas korzystania z Google Cloud.

Czym są metadane w Dysku i jak szeroki jest zakres tego terminu?

W Dysku Google metadane obejmują informacje takie jak nazwa, typ MIME, domniemane rozszerzenie, etykiety, indeksowalny tekst i powiązane miniatury. Niektóre elementy można edytować lub usunąć (np. etykiety), inne są aktualizowane pośrednio (indeksowalny tekst i miniatury), a jeszcze innych nie można usunąć, ponieważ są częścią systemu (np. rozmiar pliku lub wewnętrzne daty utworzenia i aktualizacji).

Odniesienia do metadanych znajdziesz również w innych produktach Google Cloud, takich jak Cloud Storage czy Compute Engine. Nie należy mylić metadanych maszyny wirtualnej lub obiektu w usłudze Cloud Storage z metadanymi pliku na Dysku.; podzielają tę samą koncepcję, ale ich zarządzanie i ograniczenia są różne.
Zarządzaj metadanymi w Dysku

Co można faktycznie usunąć z Dysku

Z praktycznego punktu widzenia, najczęściej „usuwanie metadanych” w Dysku oznacza usuwanie etykiet przypisanych do pliku. Etykiety mogą zawierać pola (tekst, użytkownika itp.), a ich usunięcie powoduje usunięcie powiązanych z nimi informacji z pliku . To usuwanie odbywa się za pośrednictwem interfejsu API z wykorzystaniem operacji atomowych.

Tekst indeksowalny (contentHints.indexableText) nie jest po prostu „usuwany” przyciskiem; jest nadpisywany lub pozostawiany pusty po aktualizacji zasobu pliku . Został zaprojektowany w celu ułatwienia wyszukiwania typów plików, których Dysk nie indeksuje natywnie.

Niestandardowe miniatury są obsługiwane w podobny sposób: możesz przesłać inny obraz miniatury lub zrezygnować z jego udostępniania . Jeśli Dysk może wygenerować standardową miniaturę, użyje własnej; jeśli nie, użyje tej, którą dostarczysz.

Niektórych metadanych w Dysku, takich jak rozmiar pliku i wewnętrzne znaczniki czasu, nie można usunąć. Te właściwości systemowe są aktualizowane przez samą usługę i nie można ich bezpośrednio usunąć.

Usuwanie etykiet z pliku w Dysku Google

Interfejs API Dysku umożliwia modyfikowanie lub usuwanie etykiet za pomocą metody files.modifyLabels. Żądanie obejmuje obiekt typu ModifyLabelsRequest z jedną lub większą liczbą modyfikacji, które są stosowane atomowo. (jeśli którykolwiek z nich jest nieważny, nic nie ma zastosowania).

Aby całkowicie usunąć tag z pliku, wyślij LabelModification z identyfikatorem etykiety i instrukcją kasowania. Ten proces usuwa wszystkie pola z danego znacznika w pliku.Jeśli chcesz wyłączyć tylko konkretne pole, możesz „odznaczyć” to pole bez usuwania całego znacznika.

Koncepcyjne kroki usuwania tagu z określonego pliku: 1) identyfikuje labelId etykiety obecnej w pliku (możesz je wymienić za pomocą files.listLabels), 2) Prześlij modyfikację z aktywną opcją removeLabel, 3) sprawdza, czy odpowiedź zawiera końcowy stan zaktualizowanych etykiet.

Tekst indeksowalny: kontrola, ograniczenia i dobre praktyki

Jeśli Twoja aplikacja zapisuje typy plików, których Dysk nie indeksuje samodzielnie (rysunki, filmy, skróty itp.), możesz zwiększyć możliwość wyszukiwania, wypełniając contentHints.indexableText. Tekst ten jest przetwarzany w formacie HTML, indeksowany i może pojawiać się w podsumowaniach wyników. na większej liczbie powierzchni wyszukiwania.

Ważne zalecenia i ograniczenia: maksymalny rozmiar indexableText wynosi 128 KB ; wychwytuj terminy i koncepcje, które rzeczywiście opisują treść; nie próbuj porządkować tekstu według trafności, indeksator i tak ustala priorytety; aktualizuj tekst przy każdym zapisie ; unikaj „wypełniania” niepowiązanymi słowami kluczowymi (może to frustrować użytkowników i zachęcać do usuwania treści).

Pamiętaj, że ponieważ jest to traktowane jako HTML, indeksowana jest zawartość tekstowa, a nie atrybuty . Na przykład, jeśli Twój ciąg zawiera tagi z atrybutami, indeksowany będzie widoczny tekst, a nie wartości tych atrybutów.

Miniatury: przesyłanie, zastępowanie i odzyskiwanie

Dysk automatycznie generuje miniatury dla Dokumentów, Arkuszy, Prezentacji i innych typów dokumentów. Jeśli wybrany przez Ciebie typ pliku nie generuje standardowej miniatury, możesz ją przesłać. konfigurowanie contentHints.thumbnail podczas tworzenia lub aktualizowania pliku.

Wymagania dotyczące niestandardowych miniatur: Użyj formatu PNG, GIF lub JPG; zalecana szerokość 1600 px (minimum 220 px); maksymalny rozmiar pliku 2 MB; zawiera obraz zakodowany w formacie Base64, bezpieczny dla adresu URL, oraz mimeType poprawne. Miniatura musi być aktualizowana przy każdym zapisywaniu, ponieważ traci on ważność, gdy zmienia się zawartość pliku (zmiany samych metadanych nie powodują jego unieważnienia).

Aby pobrać miniaturę, zaznacz pole thumbnailLink zasobu files. Jest to link krótkotrwały i pojawia się tylko wtedy, gdy Twoja aplikacja może uzyskać dostęp do zawartości.Jeśli plik nie jest publiczny, aby skorzystać z tego łącza, będziesz potrzebować danych uwierzytelniających.

Przykłady zapytań o metadane za pomocą miniatur za pośrednictwem REST:

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=id,name,mimeType,thumbnailLink
GET https://www.googleapis.com/drive/v3/files?q=mimeType='application/vnd.google-apps.spreadsheet'&fields=files(id,name,mimeType,thumbnailLink)

Nazwy plików i rozszerzenia: co warto wiedzieć

Podczas wstawiania pliku za pomocą API zaleca się określenie rozszerzenia we właściwości name (na przykład kot.jpg). Dysk będzie propagował to rozszerzenie jako fileExtension tylko do odczytu w kolejnych odpowiedziach, a gdy użytkownik pobierze plik lub zsynchronizuje go z klientem stacjonarnym, pełna nazwa zostanie wygenerowana na podstawie tytułu.

Jeśli nie podasz rozszerzenia, Dysk spróbuje je ustalić na podstawie typu MIME . Jeśli to możliwe, określ je, aby uniknąć niespodzianek.

Nie należy mylić usuwania metadanych z usuwaniem plików.

Usuwanie metadanych i usuwanie plików to dwie różne czynności. Jeśli jesteś właścicielem pliku i przeniesiesz go do Kosza, nie usuwasz metadanych, tylko usuwasz plik z dysku . Opcja usuwania (gdy nie jesteś właścicielem) po prostu ukrywa plik przed Tobą, ale inni nadal będą go widzieć.

Aby przenieść plik do kosza w internecie: przejdź na drive.google.com, kliknij prawym przyciskiem myszy i wybierz opcję „Przenieś do kosza” . Jeśli plik należy do kogoś innego, zobaczysz opcję „Usuń”. Aby trwale usunąć plik, opróżnij kosz. Żadna z tych czynności nie usuwa metadanych z zapisanego pliku: możesz usunąć plik lub zarządzać jego metadanymi za pomocą opisanych opcji.

Przesyłanie i przechowywanie metadanych w chmurze (w przypadku przenoszenia danych)

Podczas korzystania z usługi Storage Transfer Service do/z Cloud Storage obowiązują reguły określające, które metadane są zachowywane, a które nie. Jest to kluczowe, jeśli korzystasz z Dysku z kontenerami lub migrujesz dane między chmurami.

Z Amazon S3 lub kompatybilnego do pamięci masowej w chmurze

• Są zachowane pola metadanych o stałym kluczu (np. Cache-Control, Content-Disposition, Content-Type).
• Zdefiniowane przez użytkownika metadane są przekazywane do niestandardowe metadane w usłudze Cloud Storage (edytowalna).
• El ETag Jest zapisany jako spersonalizowany z kluczem x-goog-source-etag.
• Rozmiar obiektu jest zachowywany jako size.
• Listy kontroli dostępu S3 i znaczniki obiektów: nie są zachowane.
• Metadane znacznika czasu S3: nie są zachowaneW chmurze, timeCreated y updated odzwierciedlają moment utworzenia/aktualizacji w miejscu docelowym.
• Klasa magazynu: konfigurowalna podczas transferu (domyślnie jest to klasa magazynu docelowego).

Z Microsoft Azure Blob do pamięci masowej w chmurze

• Poprawiono pola kluczowych metadanych: są zachowane.
• Metadane zdefiniowane przez użytkownika: są zapisywane jako niestandardowe w chmurze.
• ETag Jest zachowany jako x-goog-source-etag.
• Rozmiar jako size. Uprawnienia POSIX i kontrola dostępu szczegółowego ADLS Gen2: nie są zachowane.
• Metadane znacznika czasu platformy Azure: nie są zachowane. timeCreated/updated są przeliczane w miejscu docelowym.
• Klasa pamięci masowej: konfigurowalna jak w przypadku S3.

Między kontenerami pamięci masowej w chmurze

• Stałe i niestandardowe metadane klucza: są zachowane.
• Generowanie obiektów: zapisywane jako niestandardowe metadane x-goog-reserved-source-generation.
• Retencje: dane tymczasowe są domyślnie przechowywane; dane oparte na zdarzeniach nie są przechowywane. Uważaj na LCA:Możesz je zachować, ale unikaj tworzenia niedostępnych obiektów.
• Klasa pamięci masowej: Zachowaj, ustaw nową lub użyj tej z kontenera docelowego.
• Szyfrowanie CMEK: opcjonalnie do zachowania; domyślnie używana jest metoda kontenera docelowego.
• timeCreated można przechowywać w customTime; updated no.
• Inne nieedytowalne metadane (np. etag, componentCount): Nie.

Listy adresów URL do pamięci masowej w chmurze

• Poprawiono pola kluczowych metadanych: edytowalne w miejscu docelowym.
• Content-Length y MD5: nie można edytować i są zachowywane, jeśli źródło je podaje.
• Znaczniki czasu źródła: NieKlasa pamięci masowej: konfigurowalna.

POSIX do pamięci masowej w chmurze (i odwrotnie)

• mtime zachowane jako niestandardowe metadane goog-reserved-file-mtime.
• Rozmiar jest zachowany jako size. UID, GID, MODE i dowiązania symboliczne: opcjonalny przez metadataOptions.
• W POSIX do POSIX możliwe jest zachowanie UID/GID/MODE w plikach i folderach; mtime Jest on zapisywany dla plików (w folderach używany jest czas utworzenia w miejscu docelowym).

Te szczegóły mają znaczenie podczas przenoszenia danych między usługami. Nie oczekuj, że usunięcie metadanych w jednym systemie magicznie spowoduje ich zniknięcie w innym ; przestrzegaj zasad przechowywania danych dla każdego transferu.

Metadane Compute Engine (VM): ograniczenia i usuwanie, jeśli korzystasz z Google Cloud

Chociaż to nie jest Dysk, wiele zespołów uzyskuje dostęp do metadanych maszyn wirtualnych w Compute Engine. Aby to zrobić, potrzebne są odpowiednie uprawnienia IAM oraz znajomość limitów rozmiaru i zakresu.

Przede wszystkim: zainstaluj Google Cloud CLI i uruchom go po raz pierwszy gcloud init (Jeśli korzystasz z zewnętrznego dostawcy tożsamości, zaloguj się federacyjnie.) Utrzymuj CLI na bieżąco gcloud components update i ustaw domyślny region i strefę, aby uniknąć błędów zakresu.

Typowe wymagane uprawnienia: Jeśli maszyny wirtualne korzystają z kont usługowych, jest wymagane iam.serviceAccounts.actAs. W przypadku metadanych na poziomie projektu: compute.projects.get y compute.projects.setCommonInstanceMetadata. Dla metadanych strefowych: compute.instanceSettings.get y compute.instanceSettings.update. W przypadku metadanych dotyczących konkretnej maszyny wirtualnej: compute.instances.get y compute.instances.setMetadata.

Kluczowe ograniczenia: Zestaw metadanych na maszynę wirtualną ma łączną maksymalną wartość 512 KB; każdy klawisz do 128 bajtów i każda wartość do 256 KBKlucze SSH są przechowywane w ssh-keys; jeśli przekroczysz limit, Czas posprzątać nieużywane kluczeJeśli umieścisz skrypty uruchamiania/zamykania jako bezpośrednią treść, będą one wliczane do limitu; zamiast tego zapisz skrypt w pamięci masowej w chmurze i podaje tylko adres URL.

Wielkie/małe litery: klucze rozróżniają wielkość liter; wartości również, z wyjątkiem wartości logicznych. W przypadku metadanych strefowych: zarządzane tylko za pomocą gcloud lub REST; Nie można duplikować kluczy o tym samym tekście poprzez zmianę wielkości liter (np. utwórz ZONAL-METADATA-KEY, jeśli zonal-metadata-key już istnieje); i nie możesz zdefiniować wartości strefowych dla ssh-keys.

Wartości logiczne akceptują odpowiedniki: PRAWDA/FAŁSZ oraz alternatywy, takie jak T/Tak/1 i N/Nie/0, nie rozróżniając liter wielkich i małych.

Zakres i pierwszeństwo: Ta sama nazwa klucza może istnieć zarówno na poziomie projektu, jak i strefy, ale wartość strefy ma pierwszeństwo w swojej strefie . Jeśli dodasz wartość strefy, będzie ona używana dla maszyn wirtualnych w tej strefie, nawet jeśli istnieje wartość na poziomie projektu; dodanie wartości projektu nie zastępuje istniejących wartości strefy.

Typowe operacje: Możesz skonfigurować metadane projektu (dotyczy wszystkich maszyn wirtualnych), metadane strefowe (dotyczy wszystkich maszyn wirtualnych w strefie w ramach projektu) oraz metadane instancji (tylko dla jednej maszyny wirtualnej). Aby usunąć metadane, gcloud lub REST umożliwiają usuwanie metadanych projektu, strefy lub instancji w razie potrzeby.

Lokalne korzystanie z REST: Przykłady interfejsu API REST korzystają z danych uwierzytelniających podanych w interfejsie wiersza poleceń gcloud. Uwierzytelnij swoje środowisko i ponownie wykorzystaj te dane uwierzytelniające do testowania wywołań z komputera.

Praktyczne wskazówki dotyczące lepszej higieny metadanych w Dysku

Jeśli chcesz ograniczyć ilość zajmowanego miejsca na Dysku, skup się na tym, co możesz kontrolować: etykiety (usuń je, jeśli nie wnoszą wartości), indeksowalny tekst (dostosuj go lub opróżnij, jeśli nie jest potrzebny) oraz miniatury (zastąp je lub unikaj przesyłania) . Właściwości systemowe służą do audytu, a nie do usuwania.

Jeśli plik jest udostępniany i nie jesteś jego właścicielem, pamiętaj, że usunięcie go z widoku nie spowoduje usunięcia go dla innych. Skonsultuj się z właścicielem, jeśli chcesz całkowicie usunąć powiązane treści lub metadane.

Jeśli integrujesz Dysk z przepływami w chmurze lub z maszynami wirtualnymi, dokumentuj oczekiwania. Wiele metadanych ulega zmianie lub nie jest przesyłanych między systemami ; unikaj automatyzacji opartych na znacznikach czasu lub listach kontroli dostępu, które nie są zachowywane.

Dzięki tym wskazówkom będziesz mieć kontrolę nad tym, co naprawdę robi różnicę. Precyzyjnie zarządzaj tagami, kontroluj, co jest indeksowane, i decyduj, kiedy i jak używać miniatur, aby zachować równowagę między prywatnością, możliwością wyszukiwania a komfortem użytkownika.