Line data Source code
1 : use std::collections::HashMap;
2 : use std::sync::Arc;
3 :
4 : use parking_lot::Mutex;
5 : use safekeeper::state::TimelinePersistentState;
6 : use utils::id::TenantTimelineId;
7 :
8 : use super::block_storage::BlockStorage;
9 :
10 : use std::{ops::Deref, time::Instant};
11 :
12 : use anyhow::Result;
13 : use bytes::{Buf, BytesMut};
14 : use futures::future::BoxFuture;
15 : use postgres_ffi::{waldecoder::WalStreamDecoder, XLogSegNo};
16 : use safekeeper::{control_file, metrics::WalStorageMetrics, wal_storage};
17 : use tracing::{debug, info};
18 : use utils::lsn::Lsn;
19 :
20 : /// All safekeeper state that is usually saved to disk.
21 : pub struct SafekeeperDisk {
22 : pub timelines: Mutex<HashMap<TenantTimelineId, Arc<TimelineDisk>>>,
23 : }
24 :
25 : impl Default for SafekeeperDisk {
26 0 : fn default() -> Self {
27 0 : Self::new()
28 0 : }
29 : }
30 :
31 : impl SafekeeperDisk {
32 12048 : pub fn new() -> Self {
33 12048 : SafekeeperDisk {
34 12048 : timelines: Mutex::new(HashMap::new()),
35 12048 : }
36 12048 : }
37 :
38 11447 : pub fn put_state(
39 11447 : &self,
40 11447 : ttid: &TenantTimelineId,
41 11447 : state: TimelinePersistentState,
42 11447 : ) -> Arc<TimelineDisk> {
43 11447 : self.timelines
44 11447 : .lock()
45 11447 : .entry(*ttid)
46 11447 : .and_modify(|e| {
47 0 : let mut mu = e.state.lock();
48 0 : *mu = state.clone();
49 11447 : })
50 11447 : .or_insert_with(|| {
51 11447 : Arc::new(TimelineDisk {
52 11447 : state: Mutex::new(state),
53 11447 : wal: Mutex::new(BlockStorage::new()),
54 11447 : })
55 11447 : })
56 11447 : .clone()
57 11447 : }
58 : }
59 :
60 : /// Control file state and WAL storage.
61 : pub struct TimelineDisk {
62 : pub state: Mutex<TimelinePersistentState>,
63 : pub wal: Mutex<BlockStorage>,
64 : }
65 :
66 : /// Implementation of `control_file::Storage` trait.
67 : pub struct DiskStateStorage {
68 : persisted_state: TimelinePersistentState,
69 : disk: Arc<TimelineDisk>,
70 : last_persist_at: Instant,
71 : }
72 :
73 : impl DiskStateStorage {
74 68759 : pub fn new(disk: Arc<TimelineDisk>) -> Self {
75 68759 : let guard = disk.state.lock();
76 68759 : let state = guard.clone();
77 68759 : drop(guard);
78 68759 : DiskStateStorage {
79 68759 : persisted_state: state,
80 68759 : disk,
81 68759 : last_persist_at: Instant::now(),
82 68759 : }
83 68759 : }
84 : }
85 :
86 : #[async_trait::async_trait]
87 : impl control_file::Storage for DiskStateStorage {
88 : /// Persist safekeeper state on disk and update internal state.
89 28272 : async fn persist(&mut self, s: &TimelinePersistentState) -> Result<()> {
90 28272 : self.persisted_state = s.clone();
91 28272 : *self.disk.state.lock() = s.clone();
92 28272 : Ok(())
93 56544 : }
94 :
95 : /// Timestamp of last persist.
96 0 : fn last_persist_at(&self) -> Instant {
97 0 : // TODO: don't rely on it in tests
98 0 : self.last_persist_at
99 0 : }
100 : }
101 :
102 : impl Deref for DiskStateStorage {
103 : type Target = TimelinePersistentState;
104 :
105 1897854 : fn deref(&self) -> &Self::Target {
106 1897854 : &self.persisted_state
107 1897854 : }
108 : }
109 :
110 : /// Implementation of `wal_storage::Storage` trait.
111 : pub struct DiskWALStorage {
112 : /// Written to disk, but possibly still in the cache and not fully persisted.
113 : /// Also can be ahead of record_lsn, if happen to be in the middle of a WAL record.
114 : write_lsn: Lsn,
115 :
116 : /// The LSN of the last WAL record written to disk. Still can be not fully flushed.
117 : write_record_lsn: Lsn,
118 :
119 : /// The LSN of the last WAL record flushed to disk.
120 : flush_record_lsn: Lsn,
121 :
122 : /// Decoder is required for detecting boundaries of WAL records.
123 : decoder: WalStreamDecoder,
124 :
125 : /// Bytes of WAL records that are not yet written to disk.
126 : unflushed_bytes: BytesMut,
127 :
128 : /// Contains BlockStorage for WAL.
129 : disk: Arc<TimelineDisk>,
130 : }
131 :
132 : impl DiskWALStorage {
133 68759 : pub fn new(disk: Arc<TimelineDisk>, state: &TimelinePersistentState) -> Result<Self> {
134 68759 : let write_lsn = if state.commit_lsn == Lsn(0) {
135 64841 : Lsn(0)
136 : } else {
137 3918 : Self::find_end_of_wal(disk.clone(), state.commit_lsn)?
138 : };
139 :
140 68759 : let flush_lsn = write_lsn;
141 68759 : Ok(DiskWALStorage {
142 68759 : write_lsn,
143 68759 : write_record_lsn: flush_lsn,
144 68759 : flush_record_lsn: flush_lsn,
145 68759 : decoder: WalStreamDecoder::new(flush_lsn, 16),
146 68759 : unflushed_bytes: BytesMut::new(),
147 68759 : disk,
148 68759 : })
149 68759 : }
150 :
151 3918 : fn find_end_of_wal(disk: Arc<TimelineDisk>, start_lsn: Lsn) -> Result<Lsn> {
152 3918 : let mut buf = [0; 8192];
153 3918 : let mut pos = start_lsn.0;
154 3918 : let mut decoder = WalStreamDecoder::new(start_lsn, 16);
155 3918 : let mut result = start_lsn;
156 3918 : loop {
157 3918 : disk.wal.lock().read(pos, &mut buf);
158 3918 : pos += buf.len() as u64;
159 3918 : decoder.feed_bytes(&buf);
160 :
161 : loop {
162 18798 : match decoder.poll_decode() {
163 14880 : Ok(Some(record)) => result = record.0,
164 3918 : Err(e) => {
165 3918 : debug!(
166 70 : "find_end_of_wal reached end at {:?}, decode error: {:?}",
167 70 : result, e
168 70 : );
169 3918 : return Ok(result);
170 : }
171 0 : Ok(None) => break, // need more data
172 : }
173 : }
174 : }
175 3918 : }
176 : }
177 :
178 : #[async_trait::async_trait]
179 : impl wal_storage::Storage for DiskWALStorage {
180 : /// LSN of last durably stored WAL record.
181 136965 : fn flush_lsn(&self) -> Lsn {
182 136965 : self.flush_record_lsn
183 136965 : }
184 :
185 : /// Write piece of WAL from buf to disk, but not necessarily sync it.
186 3917 : async fn write_wal(&mut self, startpos: Lsn, buf: &[u8]) -> Result<()> {
187 3917 : if self.write_lsn != startpos {
188 0 : panic!("write_wal called with wrong startpos");
189 3917 : }
190 3917 :
191 3917 : self.unflushed_bytes.extend_from_slice(buf);
192 3917 : self.write_lsn += buf.len() as u64;
193 3917 :
194 3917 : if self.decoder.available() != startpos {
195 0 : info!(
196 0 : "restart decoder from {} to {}",
197 0 : self.decoder.available(),
198 0 : startpos,
199 0 : );
200 0 : self.decoder = WalStreamDecoder::new(startpos, 16);
201 3917 : }
202 3917 : self.decoder.feed_bytes(buf);
203 : loop {
204 62241 : match self.decoder.poll_decode()? {
205 3917 : None => break, // no full record yet
206 58324 : Some((lsn, _rec)) => {
207 58324 : self.write_record_lsn = lsn;
208 58324 : }
209 : }
210 : }
211 :
212 3917 : Ok(())
213 11751 : }
214 :
215 : /// Truncate WAL at specified LSN, which must be the end of WAL record.
216 6419 : async fn truncate_wal(&mut self, end_pos: Lsn) -> Result<()> {
217 6419 : if self.write_lsn != Lsn(0) && end_pos > self.write_lsn {
218 0 : panic!(
219 0 : "truncate_wal called on non-written WAL, write_lsn={}, end_pos={}",
220 0 : self.write_lsn, end_pos
221 0 : );
222 6419 : }
223 6419 :
224 6419 : self.flush_wal().await?;
225 :
226 : // write zeroes to disk from end_pos until self.write_lsn
227 6419 : let buf = [0; 8192];
228 6419 : let mut pos = end_pos.0;
229 6448 : while pos < self.write_lsn.0 {
230 29 : self.disk.wal.lock().write(pos, &buf);
231 29 : pos += buf.len() as u64;
232 29 : }
233 :
234 6419 : self.write_lsn = end_pos;
235 6419 : self.write_record_lsn = end_pos;
236 6419 : self.flush_record_lsn = end_pos;
237 6419 : self.unflushed_bytes.clear();
238 6419 : self.decoder = WalStreamDecoder::new(end_pos, 16);
239 6419 :
240 6419 : Ok(())
241 19257 : }
242 :
243 : /// Durably store WAL on disk, up to the last written WAL record.
244 46368 : async fn flush_wal(&mut self) -> Result<()> {
245 46368 : if self.flush_record_lsn == self.write_record_lsn {
246 : // no need to do extra flush
247 42480 : return Ok(());
248 3888 : }
249 3888 :
250 3888 : let num_bytes = self.write_record_lsn.0 - self.flush_record_lsn.0;
251 3888 :
252 3888 : self.disk.wal.lock().write(
253 3888 : self.flush_record_lsn.0,
254 3888 : &self.unflushed_bytes[..num_bytes as usize],
255 3888 : );
256 3888 : self.unflushed_bytes.advance(num_bytes as usize);
257 3888 : self.flush_record_lsn = self.write_record_lsn;
258 3888 :
259 3888 : Ok(())
260 139104 : }
261 :
262 : /// Remove all segments <= given segno. Returns function doing that as we
263 : /// want to perform it without timeline lock.
264 0 : fn remove_up_to(&self, _segno_up_to: XLogSegNo) -> BoxFuture<'static, anyhow::Result<()>> {
265 0 : Box::pin(async move { Ok(()) })
266 0 : }
267 :
268 : /// Release resources associated with the storage -- technically, close FDs.
269 : /// Currently we don't remove timelines until restart (#3146), so need to
270 : /// spare descriptors. This would be useful for temporary tli detach as
271 : /// well.
272 0 : fn close(&mut self) {}
273 :
274 : /// Get metrics for this timeline.
275 0 : fn get_metrics(&self) -> WalStorageMetrics {
276 0 : WalStorageMetrics::default()
277 0 : }
278 : }
|
